X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=src%2FMoof%2FLog.hh;h=c09ac017690600fb302cb79a382a5ef55b24750e;hb=299af4f2047e767e5d79501c26444473bda64c64;hp=d3e4009c4a5a43f59393a8302922e9995f12bea0;hpb=5fa5f117f28922a7e539a432367960c1a61f837d;p=chaz%2Fyoink diff --git a/src/Moof/Log.hh b/src/Moof/Log.hh index d3e4009..c09ac01 100644 --- a/src/Moof/Log.hh +++ b/src/Moof/Log.hh @@ -1,116 +1,164 @@ -/******************************************************************************* - - Copyright (c) 2009, Charles McGarvey - All rights reserved. - - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are met: - - * Redistributions of source code must retain the above copyright notice, - this list of conditions and the following disclaimer. - * Redistributions in binary form must reproduce the above copyright notice, - this list of conditions and the following disclaimer in the documentation - and/or other materials provided with the distribution. - - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" - AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE - FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR - SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - -*******************************************************************************/ +/*] Copyright (c) 2009-2010, Charles McGarvey [************************** +**] All rights reserved. +* +* vi:ts=4 sw=4 tw=75 +* +* Distributable under the terms and conditions of the 2-clause BSD license; +* see the file COPYING for a complete text of the license. +* +**************************************************************************/ #ifndef _MOOF_LOG_H_ #define _MOOF_LOG_H_ /** - * @file log.h + * \file Log.h * Functions related to logging the process. - * The logging functions are logError(), logWarning(), logInfo(), and - * logDebug(), listed from most critical to least critical. + * The logging functions are logError(), logWarning(), and logInfo(), + * listed from most critical to least critical. */ #include // exit -#include // errno -#include // strerror - - -namespace Mf { - - -/** - * Macro which tests an assertion and issues an logError() and exits if false. - * This differs from the standard assert() in that this is a runtime assertion - * test and will always be compiled in. - * @param X test to perform - */ - -#define ASSERT(X) if (!(X)) logError("false assertion at %s:%d, " #X \ - " (errno: %d, %s)", __FILE__, __LINE__, errno, strerror(errno)), exit(1) - - -/** - * Possible values used for setting the log level using LogLevel(). Log - * messages of lesser importance than the level specified are ignored. - * @see LogLevel() - */ - -typedef enum { - NONE = -1, ///< Disable all logging. - ERROR = 1, ///< Log only errors. - WARNING = 2, ///< Log warnings and errors. - INFO = 3, ///< Log info, warnings, errors. - DEBUGGING = 4 ///< Log all messages. -} LogLevel; - - -/** - * Set and/or get the level of logs which will be logged. If not called, - * defaults to WARNING - * @param level LOG_LEVEL_* constant or 0 for no change. - * @return The currently set log level. - */ - -LogLevel setLogLevel(LogLevel level); +#include /** - * Log an error. - * @param fmt Log format string. - * @param ... Extra format arguments. + * Macro which tests an assertion and issues a logError() and exits if the + * assertion is false. + * \param X test to perform */ -void logError(const char* fmt, ...); +#undef ASSERT -/** - * Log a warning. - * @param fmt Log format string. - * @param ... Extra format arguments. - */ +#if NDEBUG +#define ASSERT(X) +#else +#define ASSERT(X) if (!(X)) Mf::logError \ + << "false assertion at " << __FILE__ << ":" << __LINE__ << ", " \ + << #X, exit(1) +#endif -void logWarning(const char* fmt, ...); -/** - * Log a message. - * @param fmt Log format string. - * @param ... Extra format arguments. - */ +namespace Mf { -void logInfo(const char* fmt, ...); /** - * Log a debug message. - * @param fmt Log format string. - * @param ... Extra format arguments. + * A class for handling a log priority. There are two ways to log + * messages: by treating a log object as a function whose parameters are + * printed with default spacing, or by treating a log object as an output + * stream. Either way, any object can be printed to the log as long as + * there is an override for the ostream insertion operator. */ - -void logDebug(const char* fmt, ...); +class Log +{ +public: + + /** + * A type for the level or priority of a log message. + */ + enum Level + { + NONE = 0, ///< Disable all logging. + ERRORR = 1, ///< Log only errors. + WARNING = 2, ///< Log warnings and errors. + INFO = 3, ///< Log everything. + }; + + + /** + * Set the lowest-priority log message that will be outputted to the + * log. Any logging with a lower priority will be ignored. + * \param level The log level. + */ + static void setLevel(Level level); + + /** + * Get the current lowest-priority log level. If unchanged, the + * default level is INFO. + * \return The log level. + */ + static Level level(); + + + /** + * Construct a log with a certain priority and prefix string. + * \param level The log level. + * \param prefix The string printed before each log message. + */ + Log(Level level, const char* prefix) : + mLevel(level), + mPrefix(prefix) /* only pass literal strings */ {} + + + template + void operator () (const A& a) + { + *this << a << std::endl; + } + + template + void operator () (const A& a, const B& b) + { + *this << a << " " << b << std::endl; + } + + template + void operator () (const A& a, const B& b, const C& c) + { + *this << a << " " << b << " " << c << std::endl; + } + + template + void operator () (const A& a, const B& b, const C& c, const D& d) + { + *this << a << " " << b << " " << c << " " << d << std::endl; + } + + template + void operator () (const A& a, + const B& b, + const C& c, + const D& d, + const E& e) + { + *this << a << " " + << b << " " + << c << " " + << d << " " + << e << std::endl; + } + + +private: + + template friend std::ostream& operator << (Log&, const T&); + + static Level gLevel; + + Level mLevel; + const char* mPrefix; +}; + + +extern std::ostream& log; +extern std::ostream& nullLog; + +extern Log logError; +extern Log logWarning; +extern Log logInfo; + + +template +inline std::ostream& operator << (Log& logObj, const T& item) +{ + if (Log::gLevel < logObj.mLevel) return nullLog; + return log << logObj.mPrefix << item; +} + + +class Script; +void importLogFunctions(Script& script); } // namespace Mf