BALL::LogStreamBuf Class Reference

Stream buffer used by LogStream. More...

#include <logStream.h>

List of all members.

Public Member Functions
Constructors and Destructors
	LogStreamBuf ()
	Default constructor.
virtual	~LogStreamBuf ()
	Destructor.
Debugging and Diagnostics
virtual void	dump (std::ostream &s)
	Dump method.
Stream methods
virtual int	sync ()
	Sync method.
virtual int	overflow (int c=-1)
	Overflow method.
Static Public Attributes
Constants
static const int	MAX_LEVEL
static const int	MIN_LEVEL
static const Time	MAX_TIME
Protected Types
typedef struct LoglineStruct	Logline
Protected Member Functions
string	expandPrefix_ (const string &prefix, int level, Time time) const
Protected Attributes
char *	pbuf_
vector< Logline >	loglines_
int	level_
int	tmp_level_
list< StreamStruct >	stream_list_
string	incomplete_line_
Friends
class	LogStream

---

Detailed Description

Stream buffer used by LogStream.

This class implements the low level behaviour of LogStream . It takes care of the buffers and stores the lines written into the LogStream object. It also contains a list of streams that are associated with the LogStream object. This list contains pointers to the streams and their minimum and maximum log level. Each line entered in the LogStream is marked with its time (in fact, the time sync was called) and its loglevel. The loglevel is determined by either the current loglevel (as set by LogStream::setLevel or a temporary level (as set by LogStream::level for a single line only). For each line stored, the list of associated streams is checked whether the loglevel falls into the range declared by the stream's minimum and maximum level. If this condition is met, the logline (with its prefix, see LogStream::setPrefix ) is also copied to the associated stream and this stream is flushed, too.

---

Constructor & Destructor Documentation

BALL::LogStreamBuf::LogStreamBuf

(

)

Default constructor.

Create a new LogStreamBuf object.

virtual BALL::LogStreamBuf::~LogStreamBuf

(

)

[virtual]

Destructor.

Destruct the buffer and free all stored messages strings.

---

Member Function Documentation

virtual void BALL::LogStreamBuf::dump

(

std::ostream &

s

)

[virtual]

Dump method.

Dumps the contents of the whole message buffer including time and log level.

virtual int BALL::LogStreamBuf::overflow

(

int

c = -1

)

[virtual]

Overflow method.

This method calls sync and streambuf::overflow(c) to prevent a buffer overflow.

virtual int BALL::LogStreamBuf::sync

(

)

[virtual]

Sync method.

This method is called as soon as the ostream is flushed (especially this method is called by flush or endl). It transfers the contents of the streambufs putbuffer into a logline if a newline or linefeed character is found in the buffer ("\n" or "\r" resp.). The line is then removed from the putbuffer. Incomplete lines (not terminated by "\n" / "\r" are stored in incomplete_line_.