Abstract base class for filtering LogMessages. More...

#include <LogFilterInterface.h>

Inheritance diagram for casa::LogFilterInterface:

Public Member Functions
	LogFilterInterface ()
	Construct a filter with the LOWEST priority that you want passed.
virtual	~LogFilterInterface ()
virtual LogFilterInterface *	clone () const =0
	Clone the object.
virtual Bool	pass (const LogMessage &message) const =0
	Return True if `message` passes this filter.
Private Member Functions
	LogFilterInterface (const LogFilterInterface &other)
	Copy constructor and assignment cannot be used.
LogFilterInterface &	operator= (const LogFilterInterface &other)

Detailed Description

Abstract base class for filtering LogMessages.

Intended use:

Internal

Review Status

Reviewed By:: wbrouw
Date Reviewed:: 1996/08/21
Test programs:: tLogging
Demo programs:: dLogging

Prerequisite

LogMessage

Etymology

Log[Message] Filter.

Synopsis

The LogFilter class is used by the various log sink classes, typically accessed through LogSink , to decide whether a particular LogMessage should be accepted or rejected.

Simple filtering is based on the messages priority. In particular, you typically will choose to only pass messages greater than or equal to NORMAL in priority, but you might choose DEBUGGING to see all messages, or SEVERE to only see messages that report serious problems.

Example

Suppose we wanted to change the global sink so that it prints all messages, including debugging messages:

    LogFilter all(LogMessage::DEBUGGING);
    LogSink::globalSink().filter(all);

Motivation

Definition at line 84 of file LogFilterInterface.h.

Constructor & Destructor Documentation

casa::LogFilterInterface::LogFilterInterface ( ) [inline]

Construct a filter with the LOWEST priority that you want passed.

Thus DEBUGGING passes everything. Note that it is not possible to block SEVERE level messages, although you can use a NullLogSink which will have this effect.

Definition at line 92 of file LogFilterInterface.h.

virtual casa::LogFilterInterface::~LogFilterInterface ( ) [virtual]

casa::LogFilterInterface::LogFilterInterface ( const LogFilterInterface & other ) [private]

Copy constructor and assignment cannot be used.

Member Function Documentation

virtual LogFilterInterface* casa::LogFilterInterface::clone ( ) const [pure virtual]

Clone the object.

Implemented in casa::PlotLoggerFilter, casa::LogFilterTaql, and casa::LogFilter.

LogFilterInterface& casa::LogFilterInterface::operator= ( const LogFilterInterface & other ) [private]

virtual Bool casa::LogFilterInterface::pass ( const LogMessage & message ) const [pure virtual]

Return True if message passes this filter.