messageStream Class Reference

Class to handle messaging in a simple, consistent stream-based manner. More...

Inheritance diagram for messageStream:

Collaboration diagram for messageStream:

Public Types
enum	errorSeverity {   INFO = 1, WARNING, SERIOUS, FATAL,   INFO_STDERR = INFO | 0x10 }
	Message type, or error severity flags. More...

Public Member Functions
	messageStream (const string &title, const errorSeverity severity, const int maxErrors=0)
	Construct from components. More...
	messageStream (const dictionary &dict)
	Construct as Fatal from dictionary, extracting the 'title'. More...
const string &	title () const
	Return the title of this error type. More...
int	maxErrors () const
	Return the maximum number of errors before program termination. More...
int &	maxErrors ()
	Return non-const access to the maximum number of errors before. More...
OSstream &	masterStream (const label communicator)
	Convert to OSstream. More...
OSstream &	operator() (const char *functionName, const char *sourceFileName, const int sourceFileLineNumber=0)
	Convert to OSstream. More...
OSstream &	operator() (const string &functionName, const char *sourceFileName, const int sourceFileLineNumber=0)
	Convert to OSstream. More...
OSstream &	operator() (const char *functionName, const char *sourceFileName, const int sourceFileLineNumber, const string &ioFileName, const label ioStartLineNumber=-1, const label ioEndLineNumber=-1)
	Convert to OSstream. More...
OSstream &	operator() (const char *functionName, const char *sourceFileName, const int sourceFileLineNumber, const IOstream &)
	Convert to OSstream. More...
OSstream &	operator() (const char *functionName, const char *sourceFileName, const int sourceFileLineNumber, const dictionary &)
	Convert to OSstream. More...
	operator OSstream & ()
	Convert to OSstream for << operations. More...
OSstream &	operator() ()
	Explicitly convert to OSstream for << operations. More...

Static Public Attributes
static int	level
	Controls the output verbosity of messageStream. More...

Protected Attributes
string	title_
errorSeverity	severity_
int	maxErrors_
int	errorCount_

Detailed Description

Class to handle messaging in a simple, consistent stream-based manner.

The messageStream class is globally instantiated with a title string and a severity (which controls the program termination) and a number of errors before termination. Errors, messages and other data are sent to the messageStream class in the standard manner.

Usage

messageStream
    << "message1" << "message2" << FoamDataType << endl;

Source files

• messageStream.H
• messageStream.C

Definition at line 71 of file messageStream.H.

Member Enumeration Documentation

errorSeverity

enum errorSeverity

Message type, or error severity flags.

Enumerator
INFO	General information output.
WARNING	Warning of possible problem.
SERIOUS	A serious problem - eg, data corruption.
FATAL	A fatal error.
INFO_STDERR	Information, but on stderr.

Definition at line 77 of file messageStream.H.

Constructor & Destructor Documentation

messageStream() [1/2]

messageStream	(	const string &	title,
		const errorSeverity	severity,
		const int	maxErrors = 0
	)

Construct from components.

Definition at line 45 of file messageStream.C.

messageStream() [2/2]

messageStream

(

const dictionary &

dict

)

Construct as Fatal from dictionary, extracting the 'title'.

Definition at line 58 of file messageStream.C.

Member Function Documentation

title()

const string& title ( ) const

inline

Return the title of this error type.

Definition at line 129 of file messageStream.H.

References messageStream::title_.

Referenced by pointNoise::processData().

Here is the caller graph for this function:

maxErrors() [1/2]

int maxErrors ( ) const

inline

Return the maximum number of errors before program termination.

Definition at line 135 of file messageStream.H.

References messageStream::maxErrors_.

maxErrors() [2/2]

int& maxErrors ( )

inline

Return non-const access to the maximum number of errors before.

program termination to enable user to reset it

Definition at line 142 of file messageStream.H.

masterStream()

Foam::OSstream & masterStream

(

const label

communicator

)

Convert to OSstream.

Prints to Pout for the master stream

Definition at line 69 of file messageStream.C.

References Foam::endl(), UPstream::master(), Foam::Pout, error::printStack(), Foam::Snull, UPstream::warnComm, and UPstream::worldComm.

Referenced by smoothSolver::solve(), fvMatrix< Type >::fvSolver::solve(), GAMGSolver::solve(), fvMatrix< Type >::solveCoupled(), fvMatrix< Type >::solver(), fvMatrix< Type >::solveSegregated(), and fvMatrix< Type >::solveSegregatedOrCoupled().

Here is the call graph for this function:

Here is the caller graph for this function:

operator()() [1/6]

Foam::OSstream & operator()	(	const char *	functionName,
		const char *	sourceFileName,
		const int	sourceFileLineNumber = 0
	)

Convert to OSstream.

Prints basic message and returns OSstream for further info.

Definition at line 89 of file messageStream.C.

References Foam::endl(), and Foam::nl.

Here is the call graph for this function:

operator()() [2/6]

Foam::OSstream & operator()	(	const string &	functionName,
		const char *	sourceFileName,
		const int	sourceFileLineNumber = 0
	)

Convert to OSstream.

Prints basic message and returns OSstream for further info.

Definition at line 108 of file messageStream.C.

operator()() [3/6]

Foam::OSstream & operator()	(	const char *	functionName,
		const char *	sourceFileName,
		const int	sourceFileLineNumber,
		const string &	ioFileName,
		const label	ioStartLineNumber = -1,
		const label	ioEndLineNumber = -1
	)

Convert to OSstream.

Prints basic message and returns OSstream for further info.

Definition at line 124 of file messageStream.C.

References Foam::endl(), and Foam::nl.

Here is the call graph for this function:

operator()() [4/6]

Foam::OSstream & operator()	(	const char *	functionName,
		const char *	sourceFileName,
		const int	sourceFileLineNumber,
		const IOstream &	ioStream
	)

Convert to OSstream.

Prints basic message and returns OSstream for further info.

Definition at line 161 of file messageStream.C.

operator()() [5/6]

Foam::OSstream & operator()	(	const char *	functionName,
		const char *	sourceFileName,
		const int	sourceFileLineNumber,
		const dictionary &	dict
	)

Convert to OSstream.

Prints basic message and returns OSstream for further info.

Definition at line 181 of file messageStream.C.

References dict, dictionary::endLineNumber(), dictionary::name(), and dictionary::startLineNumber().

Here is the call graph for this function:

operator OSstream &()

operator OSstream &

(

)

Convert to OSstream for << operations.

operator()() [6/6]

OSstream& operator() ( )

inline

Explicitly convert to OSstream for << operations.

Definition at line 206 of file messageStream.H.

Member Data Documentation

title_

string title_

protected

Definition at line 91 of file messageStream.H.

Referenced by messageStream::title().

severity_

errorSeverity severity_

protected

Definition at line 92 of file messageStream.H.

maxErrors_

int maxErrors_

protected

Definition at line 93 of file messageStream.H.

Referenced by messageStream::maxErrors().

errorCount_

int errorCount_

protected

Definition at line 94 of file messageStream.H.

level

int level

static

Controls the output verbosity of messageStream.

• level == 0 : suppress all output
• level == 1 : normal output

• level >= 2 : report source file name and line number if available

  Note

  The default level is normally 2.

Definition at line 108 of file messageStream.H.

Referenced by IOobject::setBad(), error::write(), and IOerror::write().

---

The documentation for this class was generated from the following files:

• src/OpenFOAM/db/error/messageStream.H
• src/OpenFOAM/db/error/messageStream.C