|
ROSE 0.11.145.147
|
Collection of facilities.
A facility group is a collection of message facilities that allows its members to be configured collectively, such as from command-line parsing. Each stream can be enabled or disabled individually, a member facility can be enabled or disabled as a whole, or specific importance levels can be enabled or disabled across the entire collection.
Whenever a member facility is enabled as a whole, the current set of enabled importance levels is used. This set is maintained automatically: when the first facility is inserted, its enabled importance levels initialize the default set. Whenever a message importance level is enabled or diabled via the version of enable or disable that takes an importance argument, the set is adjusted.
Thread safety: This object is thread safe.
#include <Sawyer/Message.h>
Public Types | |
| typedef std::set< Importance > | ImportanceSet |
| A set of importance levels. | |
Public Member Functions | |
| Facilities () | |
| Constructs an empty container of Facility objects. | |
| Facilities (const Facilities &) | |
| Copy constructor. | |
| Facilities & | operator= (const Facilities &) |
| Assignment operator. | |
| ImportanceSet | impset () const |
| Return the set of default-enabled message importances. | |
| Facilities & | impset (Importance, bool enabled) |
| Add or remove a default importance level. | |
| Facilities & | erase (const std::string &name) |
| Remove a facility by name. | |
| Facilities & | erase (Facility &facility) |
| Remove all occurrences of the facility. | |
| Facility & | facility (const std::string &name) const |
| Return an existing facility by name. | |
| std::vector< std::string > | facilityNames () const |
| Return names for all known facilities. | |
| std::string | control (const std::string &s) |
| Parse a single command-line switch and enable/disable the indicated streams. | |
| std::string | configuration () const |
| Returns a configuration string. | |
| void | shutdown () |
| Reset facilities to initial state. | |
| void | print (std::ostream &) const |
| Print the list of facilities and their states. | |
| Facilities & | insert (Facility &facility, const std::string &name="") |
| Register a facility so it can be controlled as part of a collection of facilities. | |
| Facilities & | insertAndAdjust (Facility &facility, std::string name="") |
| Register a facility so it can be controlled as part of a collection of facilities. | |
| Facilities & | reenable () |
| Readjust all member facilities. | |
| Facilities & | reenableFrom (const Facilities &other) |
| Readjust all member facilities. | |
| Facilities & | enable (Importance, bool b=true) |
| Enable/disable specific importance level across all facilities. | |
| Facilities & | disable (Importance imp) |
| Enable/disable specific importance level across all facilities. | |
| Facilities & | disable (const std::string &switch_name) |
| Enable/disable a facility by name. | |
| Facilities & | enable (const std::string &switch_name, bool b=true) |
| Enable/disable a facility by name. | |
| Facilities & | enable (bool b=true) |
| Enable/disable all facilities. | |
| Facilities & | disable () |
| Enable/disable all facilities. | |
| typedef std::set<Importance> Sawyer::Message::Facilities::ImportanceSet |
|
inline |
Constructs an empty container of Facility objects.
Definition at line 1750 of file Message.h.
References Sawyer::Message::ERROR, Sawyer::Message::FATAL, and Sawyer::Message::WARN.
| ImportanceSet Sawyer::Message::Facilities::impset | ( | ) | const |
Return the set of default-enabled message importances.
See Facilities class documentation for details.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::impset | ( | Importance | , |
| bool | enabled | ||
| ) |
Add or remove a default importance level.
The specified level is inserted or removed from the set of default enabled importance levels without affecting any member facility objects. If this Facilities doesn't have a default importance set then it is initialized to {WARN, ERROR, FATAL} prior to adding or removing the specified level. Calling this function also prevents the first insert from initializing the set of default importance levels. See Facilities class documentation for details.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::insert | ( | Facility & | facility, |
| const std::string & | name = "" |
||
| ) |
Register a facility so it can be controlled as part of a collection of facilities.
The optional name is the FACILITY_NAME string of the control language for the inserted facility, and defaults to the facility's name (see control). The name consists of one or more symbols separated by "::", or "." and often corresponds to the source code component that it serves. Names are case-sensitive in the control language. No two facilities in the same facility group may have the same name, but a single facility may appear multiple times in the group with different names.
This method comes in two flavors: insert, and insertAndAdjust. The latter immediately enables and disables the facility's streams according to the current default importance levels of this facility group. If facility is the first facility to be inserted, and it is inserted by insert rather than insertAndAdjust, then the facility's currently enabled streams are used to initialize the set of default enabled importance levels.
The facility is incorporated by reference and should not be destroyed until after this facility group is destroyed.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::insertAndAdjust | ( | Facility & | facility, |
| std::string | name = "" |
||
| ) |
Register a facility so it can be controlled as part of a collection of facilities.
The optional name is the FACILITY_NAME string of the control language for the inserted facility, and defaults to the facility's name (see control). The name consists of one or more symbols separated by "::", or "." and often corresponds to the source code component that it serves. Names are case-sensitive in the control language. No two facilities in the same facility group may have the same name, but a single facility may appear multiple times in the group with different names.
This method comes in two flavors: insert, and insertAndAdjust. The latter immediately enables and disables the facility's streams according to the current default importance levels of this facility group. If facility is the first facility to be inserted, and it is inserted by insert rather than insertAndAdjust, then the facility's currently enabled streams are used to initialize the set of default enabled importance levels.
The facility is incorporated by reference and should not be destroyed until after this facility group is destroyed.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::erase | ( | const std::string & | name | ) |
Remove a facility by name.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::erase | ( | Facility & | facility | ) |
Remove all occurrences of the facility.
Thread safety: This method is thread-safe.
| Facility & Sawyer::Message::Facilities::facility | ( | const std::string & | name | ) | const |
Return an existing facility by name.
Returns a reference to the specified facility. Throws an std::domain_error if no facility exists with the specified name.
Thread safety: This method is thread safe, but it returns a reference to a facility that could be deleted before it can be used. The caller must ensure that no other thread is invoking the erase method concurrently on this same Facilities object.
| std::vector< std::string > Sawyer::Message::Facilities::facilityNames | ( | ) | const |
Return names for all known facilities.
Thread safety: This method is thread-safe.
| std::string Sawyer::Message::Facilities::control | ( | const std::string & | s | ) |
Parse a single command-line switch and enable/disable the indicated streams.
Returns an empty string on success, or an error message on failure. No configuration changes are made if a failure occurs.
The control string, s, is a sentence in the following language:
The language is processed left-to-right and stream states are affected immediately. This allows, for instance, turning off all streams and then selectively enabling streams.
Some examples:
The global list, AllFacilitiesControl, also affects the list of default-enabled importance levels.
Thread safety: This method is thread-safe.
| std::string Sawyer::Message::Facilities::configuration | ( | ) | const |
Returns a configuration string.
Returns a string suitable for passing to control.
| Facilities & Sawyer::Message::Facilities::reenable | ( | ) |
Readjust all member facilities.
All members are readjusted to enable only those importance levels that are part of this facility group's default importance levels. It is as if we called disable then enable for each message facility by name. See Facilities class documentation for details.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::reenableFrom | ( | const Facilities & | other | ) |
Readjust all member facilities.
All members are readjusted to enable only those importance levels that are part of this facility group's default importance levels. It is as if we called disable then enable for each message facility by name. See Facilities class documentation for details.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::enable | ( | Importance | , |
| bool | b = true |
||
| ) |
Enable/disable specific importance level across all facilities.
This method also affects the set of "current importance levels" used when enabling an entire facility.
Thread safety: This method is thread-safe.
|
inline |
|
inline |
Enable/disable a facility by name.
When disabling, all importance levels of the specified facility are disabled. When enabling, only the current importance levels are enabled for the facility. If the facility is not found then nothing happens.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::enable | ( | const std::string & | switch_name, |
| bool | b = true |
||
| ) |
Enable/disable a facility by name.
When disabling, all importance levels of the specified facility are disabled. When enabling, only the current importance levels are enabled for the facility. If the facility is not found then nothing happens.
Thread safety: This method is thread-safe.
| Facilities & Sawyer::Message::Facilities::enable | ( | bool | b = true | ) |
Enable/disable all facilities.
When disabling, all importance levels of all facilities are disabled. When enabling, only the current importance levels are enabled for each facility.
Thread safety: This method is thread-safe.
|
inline |
| void Sawyer::Message::Facilities::shutdown | ( | ) |
Reset facilities to initial state.
This function resets each referenced Facility object to its default-constructed state in preparation for program exit.
| void Sawyer::Message::Facilities::print | ( | std::ostream & | ) | const |
Print the list of facilities and their states.
This is mostly for debugging purposes. The output may have internal line feeds and will end with a line feed.
Thread safety: This method is thread-safe.
References Sawyer::Message::DEBUG.
1.9.8