Dr. Dobb's Journal - October 2007 - (Page 50)

State of the Art by Petru Marginean Logging in C++ A typesafe, threadsafe, portable logging mechanism Logging is a critical technique for troubleshooting and maintaining software systems. It’s simple, Petru is a vice president for Morgan Stanley, where he works as a C++ senior programmer in investment banking. He can be contacted at petru.marginean@gmail.com. provides information without requiring knowledge of programming language, and does not require specialized tools. Logging is a useful means to figure out if an application is actually doing what it is supposed to do. Good logging mechanisms can save long debugging sessions and dramatically increase the maintainability of applications. In this article, I present a simple—but highly useful— logging framework that is typesafe, threadsafe (at linelevel), efficient, portable, fine-grained, compact, and flexible. The complete source code, which works with Visual C++ 7.1, g++ 3.3.5, and CC 5.3 on Sun and other platforms, is available electronically; see “Resource Center,” page 5. The POSIX Standard requires that by default the stream operations are atomic…issuing two stream operations for the same stream in two threads at the same time will cause the operations to be executed as if they were issued sequentially. The buffer operations performed while reading or writing are protected from other uses of the same stream. To do this, each stream has an internal lock object that has to be (implicitly) acquired before any work can be done. The First Step Let’s take a first stab at a Log class. Listing One uses an std::ostringstream member variable called “os” to accumulate logged data. The Get() member function gives access to that variable. After all data is formatted, Log’s destructor persists the output to the standard error. You use Log class like this: Log().Get(logINFO) << “Hello “ << username; Before moving on to a more efficient implementation, let’s write code to insert tabs in proportion to the logging level, and append an std::endl to each chunk of text. This makes the log line oriented and easy to read by both humans and machines. Here’s the relevant code: Log::ReportingLevel() = logDEBUG2; const int count = 3; Log().Get(logDEBUG) << “A loop with “ << count << “ iterations”; for (int i = 0; i != count; ++i) { Log().Get(logDEBUG1) << “the counter i = “ << i; } Executing this code creates a Log object with the logINFOx logging level, fetches its std::stringstream object, formats and accumulates the user-supplied data, and finally, persists the resulting string into the log file using exactly one call to fprintf(). Why flush during destruction? The last two steps are important because they confer threadsafety to the logging mechanism. The fprintf() function is threadsafe, so even if this log is used from different threads, the output lines won’t be scrambled. According to gnu.org/software/libc/manual/html_node/Streamsand-Threads.html: 50 Dr. Dobb’s Journal l www.ddj.com l October 2007 which outputs: 22:25:23.643 22:25:23.644 22:25:23.645 22:25:23.645 DEBUG: DEBUG1: DEBUG1: DEBUG1: A loop with the counter the counter the counter 3 i i i iterations =0 =1 =2 Indentation makes the logging more readable. More leading tabs imply a more detailed level of logging. http://gnu.org/software/libc/manual/html_node/Streams-and-threads.html http://gnu.org/software/libc/manual/html_node/Streams-and-threads.html http://www.ddj.com

Table of Contents Feed for the Digital Edition of Dr. Dobb's Journal - October 2007

Cover Contents Hmmmm Alia Vox Developer Diaries Developer’s Notebook AI: It’s OK Again! Conversations Visual Cryptography and Bit-Plane Complexity Segmentation Inside the Windows Vista Disk Encryption Algorithm Memory-Aware Components Software and the Core Description Process Logging In C++ Effective Concurrency The Agile Edge Swaine’s Flames

Dr. Dobb's Journal - October 2007

For optimal viewing of this digital publication, please enable JavaScript and then refresh the page. If you would like to try to load the digital publication without using Flash Player detection, please click here.