summaryrefslogtreecommitdiff
path: root/lib/AsmJit/Logger.h
diff options
context:
space:
mode:
Diffstat (limited to 'lib/AsmJit/Logger.h')
-rw-r--r--lib/AsmJit/Logger.h194
1 files changed, 194 insertions, 0 deletions
diff --git a/lib/AsmJit/Logger.h b/lib/AsmJit/Logger.h
new file mode 100644
index 0000000..95920b0
--- /dev/null
+++ b/lib/AsmJit/Logger.h
@@ -0,0 +1,194 @@
+// AsmJit - Complete JIT Assembler for C++ Language.
+
+// Copyright (c) 2008-2010, Petr Kobalicek <kobalicek.petr@gmail.com>
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+
+// [Guard]
+#ifndef _ASMJIT_LOGGER_H
+#define _ASMJIT_LOGGER_H
+
+// [Dependencies]
+#include "Defs.h"
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <stdarg.h>
+
+// [Api-Begin]
+#include "ApiBegin.h"
+
+namespace AsmJit {
+
+//! @addtogroup AsmJit_Logging
+//! @{
+
+//! @brief Abstract logging class.
+//!
+//! This class can be inherited and reimplemented to fit into your logging
+//! subsystem. When reimplementing use @c AsmJit::Logger::log() method to
+//! log into your stream.
+//!
+//! This class also contain @c _enabled member that can be used to enable
+//! or disable logging.
+struct ASMJIT_API Logger
+{
+ // --------------------------------------------------------------------------
+ // [Construction / Destruction]
+ // --------------------------------------------------------------------------
+
+ //! @brief Create logger.
+ Logger() ASMJIT_NOTHROW;
+ //! @brief Destroy logger.
+ virtual ~Logger() ASMJIT_NOTHROW;
+
+ // --------------------------------------------------------------------------
+ // [Logging]
+ // --------------------------------------------------------------------------
+
+ //! @brief Abstract method to log output.
+ //!
+ //! Default implementation that is in @c AsmJit::Logger is to do nothing.
+ //! It's virtual to fit to your logging system.
+ virtual void logString(const char* buf, sysuint_t len = (sysuint_t)-1) ASMJIT_NOTHROW = 0;
+
+ //! @brief Log formatter message (like sprintf) sending output to @c logString() method.
+ virtual void logFormat(const char* fmt, ...) ASMJIT_NOTHROW;
+
+ // --------------------------------------------------------------------------
+ // [Enabled]
+ // --------------------------------------------------------------------------
+
+ //! @brief Return @c true if logging is enabled.
+ inline bool isEnabled() const ASMJIT_NOTHROW { return _enabled; }
+
+ //! @brief Set logging to enabled or disabled.
+ virtual void setEnabled(bool enabled) ASMJIT_NOTHROW;
+
+ // --------------------------------------------------------------------------
+ // [Used]
+ // --------------------------------------------------------------------------
+
+ //! @brief Get whether the logger should be used.
+ inline bool isUsed() const ASMJIT_NOTHROW { return _used; }
+
+ // --------------------------------------------------------------------------
+ // [LogBinary]
+ // --------------------------------------------------------------------------
+
+ //! @brief Get whether logging binary output.
+ inline bool getLogBinary() const { return _logBinary; }
+ //! @brief Get whether to log binary output.
+ inline void setLogBinary(bool val) { _logBinary = val; }
+
+ // --------------------------------------------------------------------------
+ // [Members]
+ // --------------------------------------------------------------------------
+
+protected:
+
+ //! @brief Whether logger is enabled or disabled.
+ //!
+ //! Default @c true.
+ bool _enabled;
+
+ //! @brief Whether logger is enabled and can be used.
+ //!
+ //! This value can be set by inherited classes to inform @c Logger that
+ //! assigned stream (or something that can log output) is invalid. If
+ //! @c _used is false it means that there is no logging output and AsmJit
+ //! shouldn't use this logger (because all messages will be lost).
+ //!
+ //! This is designed only to optimize cases that logger exists, but its
+ //! configured not to output messages. The API inside Logging and AsmJit
+ //! should only check this value when needed. The API outside AsmJit should
+ //! check only whether logging is @c _enabled.
+ //!
+ //! Default @c true.
+ bool _used;
+
+ //! @brief Whether to log instruction in binary form.
+ bool _logBinary;
+
+private:
+ ASMJIT_DISABLE_COPY(Logger)
+};
+
+//! @brief Logger that can log to standard C @c FILE* stream.
+struct ASMJIT_API FileLogger : public Logger
+{
+ // --------------------------------------------------------------------------
+ // [Construction / Destruction]
+ // --------------------------------------------------------------------------
+
+ //! @brief Create new @c FileLogger.
+ //! @param stream FILE stream where logging will be sent (can be @c NULL
+ //! to disable logging).
+ FileLogger(FILE* stream = NULL) ASMJIT_NOTHROW;
+
+ // --------------------------------------------------------------------------
+ // [Logging]
+ // --------------------------------------------------------------------------
+
+ virtual void logString(const char* buf, sysuint_t len = (sysuint_t)-1) ASMJIT_NOTHROW;
+
+ // --------------------------------------------------------------------------
+ // [Enabled]
+ // --------------------------------------------------------------------------
+
+ virtual void setEnabled(bool enabled) ASMJIT_NOTHROW;
+
+ // --------------------------------------------------------------------------
+ // [Stream]
+ // --------------------------------------------------------------------------
+
+ //! @brief Get @c FILE* stream.
+ //!
+ //! @note Return value can be @c NULL.
+ inline FILE* getStream() const ASMJIT_NOTHROW { return _stream; }
+
+ //! @brief Set @c FILE* stream.
+ //!
+ //! @param stream @c FILE stream where to log output (can be @c NULL to
+ //! disable logging).
+ void setStream(FILE* stream) ASMJIT_NOTHROW;
+
+ // --------------------------------------------------------------------------
+ // [Members]
+ // --------------------------------------------------------------------------
+
+protected:
+ //! @brief C file stream.
+ FILE* _stream;
+
+ ASMJIT_DISABLE_COPY(FileLogger)
+};
+
+//! @}
+
+} // AsmJit namespace
+
+// [Api-End]
+#include "ApiEnd.h"
+
+// [Guard]
+#endif // _ASMJIT_LOGGER_H