odebug.h

Go to the documentation of this file.

/*
                             This file is part of the Opie Project
                             (C) 2003 Michael 'Mickey' Lauer (mickey@tm.informatik.uni-frankfurt.de)
                             Inspired by the KDE debug classes, which are
                             (C) 1997 Matthias Kalle Dalheimer (kalle@kde.org)
                             (C) 2002 Holger Freyther (freyther@kde.org)
              =.
            .=l.
           .>+-=
 _;:,     .>    :=|.         This program is free software; you can
.> <`_,   >  .   <=          redistribute it and/or  modify it under
:`=1 )Y*s>-.--   :           the terms of the GNU Library General Public
.="- .-=="i,     .._         License as published by the Free Software
 - .   .-<_>     .<>         Foundation; either version 2 of the License,
     ._= =}       :          or (at your option) any later version.
    .%`+i>       _;_.
    .i_,=:_.      -<s.       This program is distributed in the hope that
     +  .  -:.       =       it will be useful,  but WITHOUT ANY WARRANTY;
    : ..    .:,     . . .    without even the implied warranty of
    =_        +     =;=|`    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; see the file COPYING.LIB.
                             If not, write to the Free Software Foundation,
                             Inc., 59 Temple Place - Suite 330,
                             Boston, MA 02111-1307, USA.
*/

#ifndef ODEBUG_H
#define ODEBUG_H

#include <qstring.h>

class QWidget;
class QDateTime;
class QDate;
class QTime;
class QPoint;
class QSize;
class QRect;
class QRegion;
class QStringList;
class QColor;
class QBrush;

namespace Opie {
namespace Core {

class odbgstream;
class ondbgstream;

#ifdef __GNUC__
#define o_funcinfo "[" << __PRETTY_FUNCTION__ << "] "
#else
#define o_funcinfo "[" << __FILE__ << ":" << __LINE__ << "] "
#endif

#define o_lineinfo "[" << __FILE__ << ":" << __LINE__ << "] "

#define owarn Opie::Core::odWarning()
#define oerr Opie::Core::odError()
#define odebug Opie::Core::odDebug()
#define ofatal Opie::Core::odFatal()
#define oendl "\n"

const int ODEBUG_IGNORE = -1;
const int ODEBUG_FILE   = 0;
const int ODEBUG_MSGBOX = 1;
const int ODEBUG_STDERR = 2;
const int ODEBUG_SYSLOG = 3;
const int ODEBUG_SOCKET = 4;

class odbgstreamprivate;
/*======================================================================================
 * odbgstream
 *======================================================================================*/

class odbgstream
{
  public:
    odbgstream(unsigned int _area, unsigned int _level, bool _print = true);
    odbgstream(const char * initialString, unsigned int _area, unsigned int _level, bool _print = true);
    odbgstream(odbgstream &str);
    odbgstream(const odbgstream &str);
    virtual ~odbgstream();

    odbgstream &operator<<(bool i);
    odbgstream &operator<<(short i);
    odbgstream &operator<<(unsigned short i);
    odbgstream &operator<<(char i);
    odbgstream &operator<<(unsigned char i);
    odbgstream &operator<<(int i);
    odbgstream &operator<<(unsigned int i);
    odbgstream &operator<<(long i);
    odbgstream &operator<<(unsigned long i);
    virtual void flush();
    odbgstream &operator<<(const QString& string);
    odbgstream &operator<<(const char *string);
    odbgstream &operator<<(const QCString& string);
    odbgstream& operator<<(const void * p);
    odbgstream& operator<<(double d);
    odbgstream &form(const char *format, ...);
    odbgstream& operator<< (QWidget* widget);

    odbgstream& operator<< ( const QDateTime& dateTime );

    odbgstream& operator<< ( const QDate& date );

    odbgstream& operator<< ( const QTime& time );

    odbgstream& operator<< ( const QPoint& point );

    odbgstream& operator<< ( const QSize& size );

    odbgstream& operator<< ( const QRect& rect);

    odbgstream& operator<< ( const QRegion& region);

    odbgstream& operator<< ( const QStringList& list);

    odbgstream& operator<< ( const QColor& color);

    odbgstream& operator<< ( const QBrush& brush );

 private:
    QString output;
    unsigned int area, level;
    bool print;
    odbgstreamprivate* d;
};

inline odbgstream& endl( odbgstream &s) { s << "\n"; return s; }
inline odbgstream& flush( odbgstream &s) { s.flush(); return s; }

odbgstream &perror( odbgstream &s);

class ondbgstream {
 public:
    ondbgstream() {}
    ~ondbgstream() {}
    ondbgstream &operator<<(short int )  { return *this; }
    ondbgstream &operator<<(unsigned short int )  { return *this; }
    ondbgstream &operator<<(char )  { return *this; }
    ondbgstream &operator<<(unsigned char )  { return *this; }
    ondbgstream &operator<<(int )  { return *this; }
    ondbgstream &operator<<(unsigned int )  { return *this; }
    void flush() {}
    ondbgstream &operator<<(const QString& ) { return *this; }
    ondbgstream &operator<<(const QCString& ) { return *this; }
    ondbgstream &operator<<(const char *) { return *this; }
    ondbgstream& operator<<(const void *) { return *this; }
    ondbgstream& operator<<(void *) { return *this; }
    ondbgstream& operator<<(double) { return *this; }
    ondbgstream& operator<<(long) { return *this; }
    ondbgstream& operator<<(unsigned long) { return *this; }
    ondbgstream& operator << (QWidget*) { return *this; }
    ondbgstream &form(const char *, ...) { return *this; }

    ondbgstream& operator<<( const QDateTime& ) { return *this; }
    ondbgstream& operator<<( const QDate&     ) { return *this; }
    ondbgstream& operator<<( const QTime&     ) { return *this; }
    ondbgstream& operator<<( const QPoint & )  { return *this; }
    ondbgstream& operator<<( const QSize & )  { return *this; }
    ondbgstream& operator<<( const QRect & )  { return *this; }
    ondbgstream& operator<<( const QRegion & ) { return *this; }
    ondbgstream& operator<<( const QStringList & ) { return *this; }
    ondbgstream& operator<<( const QColor & ) { return *this; }
    ondbgstream& operator<<( const QBrush & ) { return *this; }

private:
    class Private;
    Private *d;
};

/*======================================================================================
 * related functions
 *======================================================================================*/

inline ondbgstream& endl( ondbgstream & s) { return s; }
inline ondbgstream& flush( ondbgstream & s) { return s; }
inline ondbgstream& perror( ondbgstream & s) { return s; }

odbgstream odDebug(int area = 0);
odbgstream odDebug(bool cond, int area = 0);
QString odBacktrace(int levels = -1);
inline ondbgstream ondDebug(int = 0) { return ondbgstream(); }
inline ondbgstream ondDebug(bool , int  = 0) { return ondbgstream(); }
inline QString ondBacktrace() { return QString::null; }
inline QString ondBacktrace(int) { return QString::null; }

odbgstream odWarning(int area = 0);
odbgstream odWarning(bool cond, int area = 0);
odbgstream odError(int area = 0);
odbgstream odError(bool cond, int area = 0);
odbgstream odFatal(int area = 0);
odbgstream odFatal(bool cond, int area = 0);

void odClearDebugConfig();

#ifdef OPIE_NO_DEBUG
#define odDebug ondDebug
#define odBacktrace ondBacktrace
#endif

}
}

#endif

---