Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/libraries/util/Debug.h @ 8323

Last change on this file since 8323 was 7401, checked in by landauf, 14 years ago

merged doc branch back to trunk

  • Property svn:eol-style set to native
File size: 4.3 KB
RevLine 
[1505]1/*
2 *   ORXONOX - the hottest 3D action shooter ever to exist
3 *                    > www.orxonox.net <
4 *
5 *
6 *   License notice:
7 *
8 *   This program is free software; you can redistribute it and/or
9 *   modify it under the terms of the GNU General Public License
10 *   as published by the Free Software Foundation; either version 2
11 *   of the License, or (at your option) any later version.
12 *
13 *   This program is distributed in the hope that it will be useful,
14 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 *   GNU General Public License for more details.
17 *
18 *   You should have received a copy of the GNU General Public License
19 *   along with this program; if not, write to the Free Software
20 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
21 *
22 *   Author:
[6105]23 *      Fabian 'x3n' Landau
24 *      Reto Grieder
[1505]25 *   Co-authors:
[6105]26 *      ...
[1505]27 *
28 */
29
30/**
[7401]31    @defgroup COUT COUT(x) output macro
32    @ingroup Util
33*/
34
35/**
[6105]36@file
[7401]37@ingroup COUT
[6105]38@brief
[7401]39    Handles different output-levels of errors, warnings, infos, and debug information.
[1791]40
[7401]41    The COUT(level) macro acts like @c std::cout, but the output is only performed if the given
[1791]42    level is <= the soft debug level.
43
44    There are two used values in this file:
[6105]45     - The hard debug level is used during compile time. It describes the highest allowed output level.
[1791]46     - The soft debug level is used during runtime and is the maximum of the three configurable
[7401]47       output-levels for console, log file, and in game shell.
[1791]48
49    The separation between the three devices is done by the OutputHandler.
50
[7401]51    @anchor COUTlevels
[1791]52    Possible levels are:
[7401]53     - 0: Very important output
54     - 1: Errors
55     - 2: Warnings
56     - 3: Information
57     - 4: Debug information
58     - 5: More debug information
59     - 6: Crazy debug information
[1791]60
[7401]61    Example:
62    @code
[1791]63    COUT(0) << "Very important output" << std::endl;
64    COUT(1) << "Error: Something went wrong!" << std::endl;
65    COUT(2) << "Warning: There might be a problem." << std::endl;
[6105]66    COUT(3) << "Info: It's Monday" << std::endl;
[1791]67    COUT(4) << "Debug: x is 1.23456" << std::endl;
[7401]68    @endcode
[6105]69*/
[1505]70
[6105]71#ifndef _Util_Debug_H__
72#define _Util_Debug_H__
[1505]73
[1586]74#include "UtilPrereqs.h"
[1505]75#include "OutputHandler.h"
76
[2171]77namespace orxonox
[1586]78{
[6105]79    // Just for convenience
80    using std::endl;
[1586]81
[6417]82    // Adjust this to discard certain output with level > hardDebugLevel at compile time already
83#ifdef ORXONOX_RELEASE
[6443]84    const int hardDebugLevel = OutputLevel::Verbose;
[6417]85#elif defined(NDEBUG)
[6105]86    const int hardDebugLevel = OutputLevel::Verbose;
[6417]87#else
88    //! Maximum level for debug output that should be even processed at run time
89    const int hardDebugLevel = OutputLevel::Ultra;
90#endif
91
92    //! This function simply returns 0 and helps to suppress the "statement has no effect" compiler warning
93    inline int debugDummyFunction()
94    {
95        return 0;
96    }
[2087]97}
[1586]98
[6105]99/**
100@brief
[7401]101    Logs text output: You can use COUT(level) exactly like @c std::cout, but you have to specify an output level as argument.
102@param level
103    The level of the following output (passed with <tt><< "text"</tt>). Lower levels are more important. See @ref COUTlevels "the description above" for a list of possible output levels.
104
105    Example:
106    @code
107    COUT(3) << "Some info" << std::endl; // Output with level 3
108    @endcode
109@note
110    <tt>(a > b ? 0 : c << "text")</tt> is equivalent to <tt>(a > b ? 0 : (c << "text")</tt>
111    where <tt>(a > b ? 0 : )</tt> stands for COUT(x). This should explain how
[6417]112    this macro magic can possibly even work ;)
[7401]113@remarks
114    The <tt>? :</tt> operator requires both possible results to have the type of
[6105]115    the first. This is achieved by the int conversion operator dummy
[7401]116    in the @ref orxonox::OutputHandler.
[6105]117*/
118#define COUT(level)                                                    \
119    /*if*/ (level > orxonox::hardDebugLevel) ?                         \
[6417]120        orxonox::debugDummyFunction()                                  \
[6105]121    /*else*/ :                                                         \
122        /*if*/ (level > orxonox::OutputHandler::getSoftDebugLevel()) ? \
[6417]123            orxonox::debugDummyFunction()                              \
[6105]124        /*else*/ :                                                     \
125            orxonox::OutputHandler::getOutStream(level)
[1505]126
[6105]127#endif /* _Util_Debug_H__ */
Note: See TracBrowser for help on using the repository browser.