-// Stream based logging mechanism.
-//
+/** \file logstream.hxx
+ * Stream based logging mechanism.
+ */
+
// Written by Bernie Bright, 1998
//
// Copyright (C) 1998 Bernie Bright - bbright@c031.aone.net.au
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Library General Public License for more details.
//
-// You should have received a copy of the GNU Library General Public
-// License along with this library; if not, write to the
-// Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-// Boston, MA 02111-1307, USA.
+// You should have received a copy of the GNU General Public License
+// along with this program; if not, write to the Free Software
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
//
// $Id$
#ifndef _LOGSTREAM_H
#define _LOGSTREAM_H
-#ifdef HAVE_CONFIG_H
-# include <config.h>
-#endif
-
-
#include <simgear/compiler.h>
-
-// At least Irix needs this
-#ifdef SG_HAVE_NATIVE_SGI_COMPILERS
-#include <char_traits.h>
-#endif
-
-#ifdef SG_HAVE_STD_INCLUDES
-# include <streambuf>
-# include <iostream>
-#else
-# include <iostream.h>
-# include <simgear/fg_traits.hxx>
-#endif
-
#include <simgear/debug/debug_types.h>
-#ifndef SG_HAVE_NATIVE_SGI_COMPILERS
-SG_USING_STD(streambuf);
-SG_USING_STD(ostream);
-SG_USING_STD(cerr);
-SG_USING_STD(endl);
-#else
-SG_USING_STD(char_traits);
-#endif
-
-#ifdef __MWERKS__
-SG_USING_STD(iostream);
-#endif
-
-//
-// TODO:
-//
-// 1. Change output destination. Done.
-// 2. Make logbuf thread safe.
-// 3. Read environment for default debugClass and debugPriority.
-//
-
-//-----------------------------------------------------------------------------
-//
-// logbuf is an output-only streambuf with the ability to disable sets of
-// messages at runtime. Only messages with priority >= logbuf::logPriority
-// and debugClass == logbuf::logClass are output.
-//
-class logbuf : public streambuf
+#include <sstream>
+#include <vector>
+
+// forward decls
+class SGPath;
+
+namespace simgear
+{
+
+class LogCallback
{
public:
+ virtual ~LogCallback() {}
+ virtual void operator()(sgDebugClass c, sgDebugPriority p,
+ const char* file, int line, const std::string& aMessage) = 0;
-#ifndef SG_HAVE_STD_INCLUDES
- typedef char_traits<char> traits_type;
- typedef char_traits<char>::int_type int_type;
- // typedef char_traits<char>::pos_type pos_type;
- // typedef char_traits<char>::off_type off_type;
-#endif
-// logbuf( streambuf* sb ) : sbuf(sb) {}
- logbuf();
- ~logbuf();
-
- // Is logging enabled?
- bool enabled() { return logging_enabled; }
-
- // Set the logging level of subsequent messages.
- void set_log_state( fgDebugClass c, fgDebugPriority p );
-
- // Set the global logging level.
- static void set_log_level( fgDebugClass c, fgDebugPriority p );
-
- //
- void set_sb( streambuf* sb );
-
+ void setLogLevels(sgDebugClass c, sgDebugPriority p);
protected:
+ LogCallback(sgDebugClass c, sgDebugPriority p);
- inline virtual int sync();
- int_type overflow( int ch );
-// int xsputn( const char* s, istreamsize n );
-
-private:
-
- // The streambuf used for actual output. Defaults to cerr.rdbuf().
- static streambuf* sbuf;
-
- static bool logging_enabled;
- static fgDebugClass logClass;
- static fgDebugPriority logPriority;
-
+ bool shouldLog(sgDebugClass c, sgDebugPriority p) const;
private:
-
- // Not defined.
- logbuf( const logbuf& );
- void operator= ( const logbuf& );
+ sgDebugClass m_class;
+ sgDebugPriority m_priority;
};
-inline int
-logbuf::sync()
-{
-#ifdef SG_HAVE_STD_INCLUDES
- return sbuf->pubsync();
-#else
- return sbuf->sync();
-#endif
-}
+/**
+ * Helper force a console on platforms where it might optional, when
+ * we need to show a console. This basically means Windows at the
+ * moment - on other plaforms it's a no-op
+ */
+void requestConsole();
-inline void
-logbuf::set_log_state( fgDebugClass c, fgDebugPriority p )
-{
- logging_enabled = ((c & logClass) != 0 && p >= logPriority);
-}
+void shutdownLogging();
-inline logbuf::int_type
-logbuf::overflow( int c )
-{
- return logging_enabled ? sbuf->sputc(c) : (EOF == 0 ? 1: 0);
-}
+} // of namespace simgear
-//-----------------------------------------------------------------------------
-//
-// logstream manipulator for setting the log level of a message.
-//
-struct loglevel
-{
- loglevel( fgDebugClass c, fgDebugPriority p )
- : logClass(c), logPriority(p) {}
-
- fgDebugClass logClass;
- fgDebugPriority logPriority;
-};
-
-//-----------------------------------------------------------------------------
-//
-// A helper class that ensures a streambuf and ostream are constructed and
-// destroyed in the correct order. The streambuf must be created before the
-// ostream but bases are constructed before members. Thus, making this class
-// a private base of logstream, declared to the left of ostream, we ensure the
-// correct order of construction and destruction.
-//
-struct logstream_base
-{
-// logstream_base( streambuf* sb ) : lbuf(sb) {}
- logstream_base() {}
-
- logbuf lbuf;
-};
-
-//-----------------------------------------------------------------------------
-//
-//
-//
-class logstream : private logstream_base, public ostream
+/**
+ * Class to manage the debug logging stream.
+ */
+class logstream
{
public:
- // The default is to send messages to cerr.
- logstream( ostream& out )
-// : logstream_base(out.rdbuf()),
- : logstream_base(),
- ostream(&lbuf) { lbuf.set_sb(out.rdbuf());}
-
- void set_output( ostream& out ) { lbuf.set_sb( out.rdbuf() ); }
+ ~logstream();
+
+ static void initGlobalLogstream();
+ /**
+ * Set the global log class and priority level.
+ * @param c debug class
+ * @param p priority
+ */
+ void setLogLevels( sgDebugClass c, sgDebugPriority p );
+
+ bool would_log( sgDebugClass c, sgDebugPriority p ) const;
+
+ void logToFile( const SGPath& aPath, sgDebugClass c, sgDebugPriority p );
+
+ void set_log_priority( sgDebugPriority p);
+
+ void set_log_classes( sgDebugClass c);
+
+ sgDebugClass get_log_classes() const;
+
+ sgDebugPriority get_log_priority() const;
+
+ /**
+ * the core logging method
+ */
+ void log( sgDebugClass c, sgDebugPriority p,
+ const char* fileName, int line, const std::string& msg);
+
+ /**
+ * support for the SG_POPUP logging class
+ * set the content of the popup message
+ */
+ void popup( const std::string& msg);
+
+ /**
+ * retrieve the contents of the popup message and clear it's internal
+ * content. The return value may be an empty string.
+ */
+ std::string get_popup();
+
+ /**
+ * return true if a new popup message is available. false otherwise.
+ */
+ bool has_popup();
+
+ /**
+ * \relates logstream
+ * Return the one and only logstream instance.
+ * We use a function instead of a global object so we are assured that cerr
+ * has been initialised.
+ * @return current logstream
+ */
+ friend logstream& sglog();
+
+ /**
+ * register a logging callback. Note callbacks are run in a
+ * dedicated thread, so callbacks which pass data to other threads
+ * must use appropriate locking.
+ */
+ void addCallback(simgear::LogCallback* cb);
+
+ void removeCallback(simgear::LogCallback* cb);
- // Set the global log class and priority level.
- void setLogLevels( fgDebugClass c, fgDebugPriority p );
+private:
+ // constructor
+ logstream();
- // Output operator to capture the debug level and priority of a message.
- inline ostream& operator<< ( const loglevel& l );
+ std::vector<std::string> popup_msgs;
};
-inline ostream&
-logstream::operator<< ( const loglevel& l )
-{
- lbuf.set_log_state( l.logClass, l.logPriority );
- return *this;
-}
+logstream& sglog();
+
-//-----------------------------------------------------------------------------
-//
-// Return the one and only logstream instance.
-// We use a function instead of a global object so we are assured that cerr
-// has been initialised.
-//
-inline logstream&
-fglog()
-{
- static logstream logstrm( cerr );
- return logstrm;
-}
+/** \def SG_LOG(C,P,M)
+ * Log a message.
+ * @param C debug class
+ * @param P priority
+ * @param M message
+ */
+# define SG_LOGX(C,P,M) \
+ do { if(sglog().would_log(C,P)) { \
+ std::ostringstream os; os << M; \
+ sglog().log(C, P, __FILE__, __LINE__, os.str()); \
+ if (P == SG_POPUP) sglog().popup(os.str()); \
+ } } while(0)
#ifdef FG_NDEBUG
-# define FG_LOG(C,P,M)
-#elif defined( __MWERKS__ )
-# define FG_LOG(C,P,M) ::fglog() << ::loglevel(C,P) << M << std::endl
+# define SG_LOG(C,P,M) do { if(P == SG_POPUP) SG_LOGX(C,P,M) } while(0)
#else
-# define FG_LOG(C,P,M) fglog() << loglevel(C,P) << M << endl
+# define SG_LOG(C,P,M) SG_LOGX(C,P,M)
#endif
+#define SG_ORIGIN __FILE__ ":" SG_STRINGIZE(__LINE__)
+
#endif // _LOGSTREAM_H