log4cpp::StringQueueAppender - Man Page

This class puts log messages in an in-memory queue.

Synopsis

#include <StringQueueAppender.hh>

Inherits log4cpp::LayoutAppender.

Public Member Functions

StringQueueAppender (const std::string &name)
virtual ~StringQueueAppender ()
virtual bool reopen ()
Reopens the output destination of this Appender, e.g.
virtual void close ()
Release any resources allocated within the appender such as file handles, network connections, etc.
virtual size_t queueSize () const
Return the current size of the message queue.
virtual std::queue< std::string > & getQueue ()
Return the queue to which the Appends adds messages.
virtual const std::queue< std::string > & getQueue () const
Return the queue to which the Appends adds messages.
virtual std::string popMessage ()
Pop the oldest log message from the front of the queue.

Public Member Functions inherited from log4cpp::LayoutAppender
LayoutAppender (const std::string &name)
virtual ~LayoutAppender ()
virtual bool requiresLayout () const
Check if the appender requires a layout.
virtual void setLayout (Layout *layout=NULL)
Set the Layout for this appender.

Public Member Functions inherited from log4cpp::AppenderSkeleton
virtual ~AppenderSkeleton ()
Destructor for AppenderSkeleton.
virtual void doAppend (const LoggingEvent &event)
Log in Appender specific way.
virtual void setThreshold (Priority::Value priority)
Set the threshold priority of this Appender.
virtual Priority::Value getThreshold ()
Get the threshold priority of this Appender.
virtual void setFilter (Filter *filter)
Set a Filter for this appender.
virtual Filter * getFilter ()
Get the Filter for this appender.

Public Member Functions inherited from log4cpp::Appender
virtual ~Appender ()
Destructor for Appender.
const std::string & getName () const
Get the name of this appender.

Protected Member Functions

virtual void _append (const LoggingEvent &event)
Appends the LoggingEvent to the queue.

Protected Member Functions inherited from log4cpp::LayoutAppender
Layout & _getLayout ()
Return the layout of the appender.

Protected Member Functions inherited from log4cpp::AppenderSkeleton
AppenderSkeleton (const std::string &name)
Constructor for AppenderSkeleton.

Protected Member Functions inherited from log4cpp::Appender
Appender (const std::string &name)
Constructor for Appender.

Protected Attributes

std::queue< std::string > _queue

Additional Inherited Members

Public Types inherited from log4cpp::LayoutAppender

typedef BasicLayout DefaultLayoutType

Static Public Member Functions inherited from log4cpp::Appender
static Appender * getAppender (const std::string &name)
Get a pointer to an exitsing Appender.
static bool reopenAll ()
Call reopen() on all existing Appenders.
static void closeAll ()
Call reopen() on all existing Appenders.

Detailed Description

This class puts log messages in an in-memory queue.

Its primary use is in test cases, but it may be useful elsewhere as well.

Since

0.2.4

Constructor & Destructor Documentation

log4cpp::StringQueueAppender::StringQueueAppender (const std::string & name)

log4cpp::StringQueueAppender::~StringQueueAppender () [virtual]

Member Function Documentation

void log4cpp::StringQueueAppender::_append (const LoggingEvent & event) [protected], [virtual]

Appends the LoggingEvent to the queue.

Parameters

event the LoggingEvent to layout and append to the queue.

Implements log4cpp::AppenderSkeleton.

void log4cpp::StringQueueAppender::close () [virtual]

Release any resources allocated within the appender such as file handles, network connections, etc.

Implements log4cpp::AppenderSkeleton.

std::queue< std::string > & log4cpp::StringQueueAppender::getQueue () [virtual]

Return the queue to which the Appends adds messages.

Returns

the message queue

const std::queue< std::string > & log4cpp::StringQueueAppender::getQueue () const [virtual]

Return the queue to which the Appends adds messages.

Returns

the message queue

std::string log4cpp::StringQueueAppender::popMessage () [virtual]

Pop the oldest log message from the front of the queue.

Returns

the oldest log message

size_t log4cpp::StringQueueAppender::queueSize () const [virtual]

Return the current size of the message queue. Shorthand for getQueue().size().

Returns

the queue size

bool log4cpp::StringQueueAppender::reopen () [virtual]

Reopens the output destination of this Appender, e.g. the logfile or TCP socket.

Returns

false if an error occured during reopening, true otherwise.

Reimplemented from log4cpp::AppenderSkeleton.

Member Data Documentation

std::queue<std::string> log4cpp::StringQueueAppender::_queue [protected]

Author

Generated automatically by Doxygen for log4cpp from the source code.

Info

Version 1.1.3 log4cpp