MessageLogger.cc

Go to the documentation of this file.

#include <utl/MessageLogger.h>


namespace utl {

  /* 
   * Regarding the destructor for Message.
   * 
   * Note that we're not making a mistake as
   * using the character directly (in the sense
   * of using LF in a CR/LF environment).
   * Using text-mode the character gets
   * translated to the plattform-specific
   * end-of-line.
   * The difference with std::endl is that
   * this one is not a character, it's a
   * manipulator function which, in addition 
   * to inserting \n, flushes the stream:
   * that's what we're losing as using the char.
   *
   * Check the standards:
   * 
   * C (ISO/IEC 9899:TC3 Committee Draft — Septermber 7, 2007)
   *
   * 5.2.2 Character display semantics
   *  (2) \n (new line) Moves the active position to the initial position of the next line.
   *  (3) Each of these escape sequences shall produce a unique implementation-defined value
   *  which can be stored in a single char object. The external representations in a text file
   *  need not be identical to the internal representations, and are outside the scope of this
   *  International Standard.
   *
   * 7.19.2 Streams
   *  (2) Characters may have to be added, altered, or deleted on input and output to conform 
   *  to differing conventions for representing text in the host environment. Thus, there need 
   *  not be a one-to-one correspondence between the characters in a stream and those in the 
   *  external representation.
   *
   *
   * C++ (ISO/IEC 14882:2003(E))
   *
   * Table 5—escape sequences
   *
   * 27.6.2.7 Standard basic_ostream manipulators
   *  For endl it's said:
   *  Calls os.put(os.widen(’\n’) ), then os.flush().
   * 
   * 27.8 File-based streams
   *  (2) The restrictions on reading and writing a sequence controlled by an object of class
   *  basic_filebuf<charT,traits> are the same as for reading and writing with the Standard C 
   *  library FILEs.
   */

  MessageLogger::MessageLogger(std::ostream& os, unsigned int l) :
    fStream(os),
    fLevel(l),
    fFlushCounter(0),
    fFlushPeriod(0)
  { }

}