A customised textstream for fast, multithreaded logging to file. More...
#include <log_stream.hpp>
Public Member Functions | |
| void | disableHeader () |
| Disables header information. | |
| void | disableMode (int mode) |
| Disable the given log mode. | |
| void | disableTimeStamp () |
| Disable time stamps. | |
| void | enableHeader () |
| Enable header information. | |
| void | enableMode (int mode, const std::string header="") |
| Enable the given mode and associate the specified header. | |
| void | enableTimeStamp () |
| Enable time stamps. | |
| bool | isEnabled () |
| Check to see if any modes are enabled. | |
| bool | isModeEnabled (int mode) |
| Check to see if a particular mode is enabled. | |
| LogStream & | log (int mode) |
| Log streaming function. | |
| LogStream (const std::string &file_name, const WriteMode &mode=New) ecl_throw_decl(StandardException) | |
| Convenience constructor for logstreams. | |
| LogStream () | |
| Default constructor, underlying device must be manually opened. | |
| virtual | ~LogStream () |
Private Attributes | |
| std::map< int, std::string > | modes |
| TimeStamp | timestamp |
| bool | write_header |
| bool | write_stamp |
A customised textstream for fast, multithreaded logging to file.
Together with the LOG and FLUSH macros, this class enables fast, multithreaded logging with multiple modes, customisable headers and timestamps.
Usage:
Multiple modes are most conveniently utilsed via customised enums. For example:
Note that this is an advantage over alot of other loggers in that it gives you the freedom to define your own error logging levels. Each mode can then be associated inside the log stream with its own customised header.
LogStream log_stream("test.log") log_stream.enableMode(Warning,"WARNING"); log_stream.enableMode(Error,"ERROR"); log_stream.enableMode(Debug,"DEBUG");
This process can be repeated from multiple threads each with its own instance of the log stream attached to the single file. Using the log stream is then done via the macros LOG and FLUSH
LOG(log_stream, Warning) << "This is a log message from main().\n";
FLUSH(log_stream)
By default this will automatically add header and timestamp information. You can manually disable these if you prefer.
Definition at line 109 of file log_stream.hpp.
| ecl::LogStream::LogStream | ( | ) | [inline] |
Default constructor, underlying device must be manually opened.
This must open the underlying shared file device manually via device().open() as you would do if using a TextStream.
Definition at line 117 of file log_stream.hpp.
| ecl::LogStream::LogStream | ( | const std::string & | file_name, | |
| const WriteMode & | mode = New | |||
| ) | [inline] |
Convenience constructor for logstreams.
This constructor enables RAII style construction of the underlying shared file device.
| file_name | : output file name. | |
| mode | : mode for writing (New, Append). |
| StandardException | : throws if the connection failed to open. |
Definition at line 129 of file log_stream.hpp.
| virtual ecl::LogStream::~LogStream | ( | ) | [inline, virtual] |
Definition at line 142 of file log_stream.hpp.
| void ecl::LogStream::disableHeader | ( | ) |
Disables header information.
This turns off printing of the header at the beginning of any logging message.
Definition at line 33 of file log_stream.cpp.
| void ecl::LogStream::disableMode | ( | int | mode | ) |
Disable the given log mode.
Disable the given log mode.
| mode | : the log mode. |
Definition at line 38 of file log_stream.cpp.
| void ecl::LogStream::disableTimeStamp | ( | ) |
Disable time stamps.
This disables timestamps at the beginning of any logging message. The timestamp is in the format seconds.nanoseconds (think unix time).
Definition at line 35 of file log_stream.cpp.
| void ecl::LogStream::enableHeader | ( | ) |
Enable header information.
This prints the header at the beginning of any logging message. The header is a string that is specified when calling the enableMode() function.
Definition at line 32 of file log_stream.cpp.
| void ecl::LogStream::enableMode | ( | int | mode, | |
| const std::string | header = "" | |||
| ) |
Enable the given mode and associate the specified header.
Enable the given log mode and associate it with the specified header string.
| mode | : the log mode. | |
| header | : the string to precede the log message if required. |
Definition at line 37 of file log_stream.cpp.
| void ecl::LogStream::enableTimeStamp | ( | ) |
Enable time stamps.
This prints a timestamp at the beginning of any logging message. The timestamp is in the format seconds.nanoseconds (think unix time).
Definition at line 34 of file log_stream.cpp.
| bool ecl::LogStream::isEnabled | ( | ) |
Check to see if any modes are enabled.
Check to see if any modes are enabled.
Definition at line 40 of file log_stream.cpp.
| bool ecl::LogStream::isModeEnabled | ( | int | mode | ) |
Check to see if a particular mode is enabled.
Check to see if the specified mode is enabled.
Definition at line 48 of file log_stream.cpp.
| LogStream & ecl::LogStream::log | ( | int | mode | ) |
Log streaming function.
Do not use this directly, rather it is indirectly utilised by the LOG macro, which should only reach here once isModeEnabled() is checked. It adds a header and timestamp if it is configured to do so and then passes the stream to the program for further additions.
| mode | : log mode that is being logged. |
Definition at line 57 of file log_stream.cpp.
std::map<int,std::string> ecl::LogStream::modes [private] |
Definition at line 220 of file log_stream.hpp.
TimeStamp ecl::LogStream::timestamp [private] |
Definition at line 221 of file log_stream.hpp.
bool ecl::LogStream::write_header [private] |
Definition at line 218 of file log_stream.hpp.
bool ecl::LogStream::write_stamp [private] |
Definition at line 219 of file log_stream.hpp.