ROSE  0.11.96.11
Public Member Functions | List of all members
Sawyer::Message::Mesg Class Reference

Description

A single message.

A message consists of a string and can be in a partial, completed, or canceled state. More text can be added to a message while it is in the partial state, but once the message is marked as completed or canceled the text becomes immutable. Messages also have properties, which are fed into the plumbing lattice and adjusted as they traverse to the final destinations during a process called "baking".

Thread safety: This object uses global state, but is otherwise not thread-safe except where noted.

Definition at line 513 of file Message.h.

#include <Message.h>

Public Member Functions

 Mesg ()
 Creates a new, partial message that is empty.
 
 Mesg (const std::string &facilityName, Importance imp)
 Creates a new, partial message that is empty. More...
 
 Mesg (const MesgProps &props)
 Creates a new, partial message that is empty. More...
 
 Mesg (const std::string &mesg)
 Creates a new, completed message with the specified text.
 
 Mesg (const std::string &facilityName, Importance imp, const std::string &mesg)
 Creates a new, completed message with the specified text. More...
 
 Mesg (const MesgProps &props, const std::string &mesg)
 Creates a new, completed message with the specified text. More...
 
unsigned id () const
 Return unique message ID. More...
 
const std::string & text () const
 Return the message text.
 
bool isComplete () const
 Returns true if the message has entered the completed state. More...
 
bool isCanceled () const
 Returns true if the message has entered the canceled state. More...
 
bool isEmpty () const
 Returns true if the message has no text. More...
 
bool hasText () const
 Returns true if the message has text other than white space. More...
 
void complete ()
 Cause the message to enter the completed state. More...
 
void cancel ()
 Cause the message to enter the canceled state. More...
 
void post (const BakedDestinations &) const
 Send a message to its final destinations.
 
const MesgPropsproperties () const
 Returns a reference to message properties. More...
 
MesgPropsproperties ()
 Returns a reference to message properties. More...
 
void insert (const std::string &)
 Append additional text to the end of the message. More...
 
void insert (char)
 Append additional text to the end of the message. More...
 

Constructor & Destructor Documentation

◆ Mesg() [1/4]

Sawyer::Message::Mesg::Mesg ( const std::string &  facilityName,
Importance  imp 
)
inline

Creates a new, partial message that is empty.

Sets the facility name and importance properties as specified.

Definition at line 529 of file Message.h.

References Sawyer::Message::MesgProps::facilityName, and Sawyer::Message::MesgProps::importance.

◆ Mesg() [2/4]

Sawyer::Message::Mesg::Mesg ( const MesgProps props)
inlineexplicit

Creates a new, partial message that is empty.

Initializes message properties as specified.

Definition at line 536 of file Message.h.

◆ Mesg() [3/4]

Sawyer::Message::Mesg::Mesg ( const std::string &  facilityName,
Importance  imp,
const std::string &  mesg 
)
inline

Creates a new, completed message with the specified text.

Also sets the facility name and importance properties as specified.

Definition at line 545 of file Message.h.

References Sawyer::Message::MesgProps::facilityName, and Sawyer::Message::MesgProps::importance.

◆ Mesg() [4/4]

Sawyer::Message::Mesg::Mesg ( const MesgProps props,
const std::string &  mesg 
)
inline

Creates a new, completed message with the specified text.

Also sets the message properties as specified.

Definition at line 552 of file Message.h.

Member Function Documentation

◆ id()

unsigned Sawyer::Message::Mesg::id ( ) const
inline

Return unique message ID.

Each message has an identification number that is unique within a process.

Definition at line 556 of file Message.h.

◆ isComplete()

bool Sawyer::Message::Mesg::isComplete ( ) const
inline

Returns true if the message has entered the completed state.

Once a message is completed its text cannot be changed.

Definition at line 562 of file Message.h.

◆ isCanceled()

bool Sawyer::Message::Mesg::isCanceled ( ) const
inline

Returns true if the message has entered the canceled state.

Messages typically only enter this state when they are being destroyed.

Definition at line 566 of file Message.h.

◆ isEmpty()

bool Sawyer::Message::Mesg::isEmpty ( ) const
inline

Returns true if the message has no text.

This is similar, but not identical to the the inverse of the hasText method.

Definition at line 570 of file Message.h.

◆ hasText()

bool Sawyer::Message::Mesg::hasText ( ) const

Returns true if the message has text other than white space.

This is similar, but not identical to the inverse of the isEmpty method.

◆ properties() [1/2]

const MesgProps& Sawyer::Message::Mesg::properties ( ) const
inline

Returns a reference to message properties.

Once a message's properties are "baked" by sending them through the plumbing lattice, changing the message properties has no effect on the text that is emitted by the message sinks. A stream typically bakes the message when the first text is inserted.

Definition at line 580 of file Message.h.

◆ properties() [2/2]

MesgProps& Sawyer::Message::Mesg::properties ( )
inline

Returns a reference to message properties.

Once a message's properties are "baked" by sending them through the plumbing lattice, changing the message properties has no effect on the text that is emitted by the message sinks. A stream typically bakes the message when the first text is inserted.

Definition at line 581 of file Message.h.

◆ complete()

void Sawyer::Message::Mesg::complete ( )
inline

Cause the message to enter the completed state.

Once a message enters this state its text cannot be modified.

Definition at line 585 of file Message.h.

◆ cancel()

void Sawyer::Message::Mesg::cancel ( )
inline

Cause the message to enter the canceled state.

This typically happens automatically when a message is being destroyed. Once a message enters this state its text cannot be modified.

Definition at line 589 of file Message.h.

◆ insert() [1/2]

void Sawyer::Message::Mesg::insert ( const std::string &  )

Append additional text to the end of the message.

If the message is in the completed or canceled state then an std::runtime_error is thrown.

◆ insert() [2/2]

void Sawyer::Message::Mesg::insert ( char  )

Append additional text to the end of the message.

If the message is in the completed or canceled state then an std::runtime_error is thrown.


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