sources_reference.xml 86 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800
  1. <?xml version="1.0" standalone="yes"?>
  2. <library-reference id="logging_sources"><title>Logging sources</title><header name="boost/log/sources/basic_logger.hpp">
  3. <para><para>Andrey Semashev </para>
  4. <para>08.03.2007</para>
  5. The header contains implementation of a base class for loggers. Convenience macros for defining custom loggers are also provided. </para><namespace name="boost">
  6. <namespace name="log">
  7. <namespace name="sources">
  8. <class name="basic_composite_logger"><template>
  9. <template-type-parameter name="CharT"/>
  10. <template-type-parameter name="FinalT"/>
  11. <template-type-parameter name="ThreadingModelT"/>
  12. <template-type-parameter name="FeaturesT"/>
  13. </template><purpose>A composite logger that inherits a number of features. </purpose><description><para>The composite logger is a helper class that simplifies feature composition into the final logger. The user's logger class is expected to derive from the composite logger class, instantiated with the character type, the user's logger class, the threading model and the list of the required features. The former three parameters are passed to the <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput> class template. The feature list must be an MPL type sequence, where each element is a unary MPL metafunction class, that upon applying on its argument results in a logging feature class that derives from the argument. Every logger feature provided by the library can participate in the feature list. </para></description><typedef name="threading_model"><purpose>Threading model being used. </purpose><type>base_type::threading_model</type></typedef>
  14. <method-group name="public member functions">
  15. <method name="add_attribute"><type>std::pair&lt; attribute_set::iterator, bool &gt;</type><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>The attribute name. </para></description></parameter><parameter name="attr"><paramtype>attribute const &amp;</paramtype><description><para>The attribute factory. </para></description></parameter><description><para>The method adds an attribute to the source-specific attribute set. The attribute will be implicitly added to every log record made with the current logger.</para><para>
  16. </para></description><returns><para>A pair of values. If the second member is <computeroutput>true</computeroutput>, then the attribute is added and the first member points to the attribute. Otherwise the attribute was not added and the first member points to the attribute that prevents addition. </para>
  17. </returns></method>
  18. <method name="remove_attribute"><type>void</type><parameter name="it"><paramtype>attribute_set::iterator</paramtype><description><para>Iterator to the previously added attribute. </para></description></parameter><description><para>The method removes an attribute from the source-specific attribute set.</para><para>
  19. </para></description><requires><para>The attribute was added with the add_attribute call for this instance of the logger. </para>
  20. </requires><postconditions><para>The attribute is no longer registered as a source-specific attribute for this logger. The iterator is invalidated after removal.</para>
  21. </postconditions></method>
  22. <method name="remove_all_attributes"><type>void</type><description><para>The method removes all attributes from the logger. All iterators and references to the removed attributes are invalidated. </para></description></method>
  23. <method name="get_attributes" cv="const"><type>attribute_set</type><description><para>The method retrieves a copy of a set with all attributes from the logger.</para><para>
  24. </para></description><returns><para>The copy of the attribute set. Attributes are shallow-copied. </para>
  25. </returns></method>
  26. <method name="set_attributes"><type>void</type><parameter name="attrs"><paramtype>attribute_set const &amp;</paramtype><description><para>The set of attributes to install into the logger. Attributes are shallow-copied. </para></description></parameter><description><para>The method installs the whole attribute set into the logger. All iterators and references to elements of the previous set are invalidated. Iterators to the <emphasis>attrs</emphasis> set are not valid to be used with the logger (that is, the logger owns a copy of <emphasis>attrs</emphasis> after completion).</para><para>
  27. </para></description></method>
  28. <method name="open_record"><type>record</type><description><para>The method opens a new log record in the logging core.</para><para>
  29. </para></description><returns><para>A valid record handle if the logging record is opened successfully, an invalid handle otherwise. </para>
  30. </returns></method>
  31. <method name="open_record"><type>record</type><template>
  32. <template-type-parameter name="ArgsT"/>
  33. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype><description><para>A set of additional named arguments. The parameter is ignored. </para></description></parameter><description><para>The method opens a new log record in the logging core.</para><para>
  34. </para></description><returns><para>A valid record handle if the logging record is opened successfully, an invalid handle otherwise. </para>
  35. </returns></method>
  36. <method name="push_record"><type>void</type><parameter name="rec"><paramtype>record &amp;&amp;</paramtype><description><para>The log record with the formatted message </para></description></parameter><description><para>The method pushes the constructed message to the logging core</para><para>
  37. </para></description></method>
  38. <method name="swap"><type>void</type><parameter name="that"><paramtype><classname>basic_composite_logger</classname> &amp;</paramtype></parameter><description><para>Thread-safe implementation of swap </para></description></method>
  39. </method-group>
  40. <constructor><description><para>Default constructor (default-constructs all features) </para></description></constructor>
  41. <constructor><parameter name="that"><paramtype><classname>basic_composite_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  42. <constructor><parameter name="that"><paramtype>logger_base &amp;&amp;</paramtype></parameter><description><para>Move constructor </para></description></constructor>
  43. <constructor specifiers="explicit"><template>
  44. <template-type-parameter name="ArgsT"/>
  45. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter><description><para>Constructor with named parameters </para></description></constructor>
  46. <method-group name="protected member functions">
  47. <method name="assign"><type>FinalT &amp;</type><parameter name="that"><paramtype>FinalT const &amp;</paramtype></parameter><description><para>Assignment for the final class. Threadsafe, provides strong exception guarantee. </para></description></method>
  48. </method-group>
  49. </class><class-specialization name="basic_composite_logger"><template>
  50. <template-type-parameter name="CharT"/>
  51. <template-type-parameter name="FinalT"/>
  52. <template-type-parameter name="FeaturesT"/>
  53. </template><specialization><template-arg>CharT</template-arg><template-arg>FinalT</template-arg><template-arg>single_thread_model</template-arg><template-arg>FeaturesT</template-arg></specialization><purpose>An optimized composite logger version with no multithreading support. </purpose><typedef name="threading_model"><type>base_type::threading_model</type></typedef>
  54. <method-group name="public member functions">
  55. <method name="add_attribute"><type>std::pair&lt; attribute_set::iterator, bool &gt;</type><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="attr"><paramtype>attribute const &amp;</paramtype></parameter></method>
  56. <method name="remove_attribute"><type>void</type><parameter name="it"><paramtype>attribute_set::iterator</paramtype></parameter></method>
  57. <method name="remove_all_attributes"><type>void</type></method>
  58. <method name="get_attributes" cv="const"><type>attribute_set</type></method>
  59. <method name="set_attributes"><type>void</type><parameter name="attrs"><paramtype>attribute_set const &amp;</paramtype></parameter></method>
  60. <method name="open_record"><type>record</type></method>
  61. <method name="open_record"><type>record</type><template>
  62. <template-type-parameter name="ArgsT"/>
  63. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter></method>
  64. <method name="push_record"><type>void</type><parameter name="rec"><paramtype>record &amp;&amp;</paramtype></parameter></method>
  65. <method name="swap"><type>void</type><parameter name="that"><paramtype><classname>basic_composite_logger</classname> &amp;</paramtype></parameter></method>
  66. </method-group>
  67. <constructor/>
  68. <constructor><parameter name="that"><paramtype><classname>basic_composite_logger</classname> const &amp;</paramtype></parameter></constructor>
  69. <constructor><parameter name="that"><paramtype><classname>logger_base</classname> &amp;&amp;</paramtype></parameter></constructor>
  70. <constructor specifiers="explicit"><template>
  71. <template-type-parameter name="ArgsT"/>
  72. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter></constructor>
  73. <method-group name="protected member functions">
  74. <method name="assign"><type>FinalT &amp;</type><parameter name="that"><paramtype>FinalT</paramtype></parameter></method>
  75. </method-group>
  76. </class-specialization><class name="basic_logger"><template>
  77. <template-type-parameter name="CharT"/>
  78. <template-type-parameter name="FinalT"/>
  79. <template-type-parameter name="ThreadingModelT"/>
  80. </template><inherit access="public">ThreadingModelT</inherit><purpose>Basic logger class. </purpose><description><para>The <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput> class template serves as a base class for all loggers provided by the library. It can also be used as a base for user-defined loggers. The template parameters are:</para><para><itemizedlist>
  81. <listitem><para><computeroutput>CharT</computeroutput> - logging character type </para>
  82. </listitem>
  83. <listitem><para><computeroutput>FinalT</computeroutput> - final type of the logger that eventually derives from the <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput>. There may be other classes in the hierarchy between the final class and <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput>. </para>
  84. </listitem>
  85. <listitem><para><computeroutput>ThreadingModelT</computeroutput> - threading model policy. Must provide methods of the Boost.Thread locking concept used in <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput> class and all its derivatives in the hierarchy up to the <computeroutput>FinalT</computeroutput> class. The <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput> class itself requires methods of the SharedLockable concept. The threading model policy must also be default and copy-constructible and support member function <computeroutput>swap</computeroutput>. There are currently two policies provided: <computeroutput><classname alt="boost::log::sources::single_thread_model">single_thread_model</classname></computeroutput> and <computeroutput><classname alt="boost::log::sources::multi_thread_model">multi_thread_model</classname></computeroutput>.</para>
  86. </listitem>
  87. </itemizedlist>
  88. The logger implements fundamental facilities of loggers, such as storing source-specific attribute set and formatting log record messages. The basic logger interacts with the logging core in order to apply filtering and pass records to sinks. </para></description><typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  89. <typedef name="final_type"><purpose>Final logger type. </purpose><type>FinalT</type></typedef>
  90. <typedef name="threading_model"><purpose>Threading model type. </purpose><type>ThreadingModelT</type></typedef>
  91. <typedef name="swap_lock"><purpose>Lock requirement for the swap_unlocked method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  92. <typedef name="add_attribute_lock"><purpose>Lock requirement for the add_attribute_unlocked method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  93. <typedef name="remove_attribute_lock"><purpose>Lock requirement for the remove_attribute_unlocked method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  94. <typedef name="remove_all_attributes_lock"><purpose>Lock requirement for the remove_all_attributes_unlocked method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  95. <typedef name="get_attributes_lock"><purpose>Lock requirement for the get_attributes method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  96. <typedef name="open_record_lock"><purpose>Lock requirement for the open_record_unlocked method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  97. <typedef name="set_attributes_lock"><purpose>Lock requirement for the set_attributes method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  98. <typedef name="push_record_lock"><purpose>Lock requirement for the push_record_unlocked method. </purpose><type>no_lock&lt; threading_model &gt;</type></typedef>
  99. <method-group name="public member functions">
  100. </method-group>
  101. <constructor><description><para>Constructor. Initializes internal data structures of the basic logger class, acquires reference to the logging core. </para></description></constructor>
  102. <constructor><parameter name="that"><paramtype><classname>basic_logger</classname> const &amp;</paramtype><description><para>Source logger </para></description></parameter><description><para>Copy constructor. Copies all attributes from the source logger.</para><para><note><para>Not thread-safe. The source logger must be locked in the final class before copying.</para>
  103. </note>
  104. </para></description></constructor>
  105. <constructor><parameter name="that"><paramtype><classname>basic_logger</classname> &amp;&amp;</paramtype><description><para>Source logger </para></description></parameter><description><para>Move constructor. Moves all attributes from the source logger.</para><para><note><para>Not thread-safe. The source logger must be locked in the final class before copying.</para>
  106. </note>
  107. </para></description></constructor>
  108. <constructor specifiers="explicit"><template>
  109. <template-type-parameter name="ArgsT"/>
  110. </template><parameter name=""><paramtype>ArgsT const &amp;</paramtype></parameter><description><para>Constructor with named arguments. The constructor ignores all arguments. The result of construction is equivalent to default construction. </para></description></constructor>
  111. <method-group name="protected member functions">
  112. <method name="core" cv="const"><type>core_ptr const &amp;</type><description><para>An accessor to the logging system pointer </para></description></method>
  113. <method name="attributes"><type>attribute_set &amp;</type><description><para>An accessor to the logger attributes </para></description></method>
  114. <method name="attributes" cv="const"><type>attribute_set const &amp;</type><description><para>An accessor to the logger attributes </para></description></method>
  115. <method name="get_threading_model"><type>threading_model &amp;</type><description><para>An accessor to the threading model base </para></description></method>
  116. <method name="get_threading_model" cv="const"><type>threading_model const &amp;</type><description><para>An accessor to the threading model base </para></description></method>
  117. <method name="final_this"><type>final_type *</type><description><para>An accessor to the final logger </para></description></method>
  118. <method name="final_this" cv="const"><type>final_type const *</type><description><para>An accessor to the final logger </para></description></method>
  119. <method name="swap_unlocked"><type>void</type><parameter name="that"><paramtype><classname>basic_logger</classname> &amp;</paramtype></parameter><description><para>Unlocked <computeroutput>swap</computeroutput> </para></description></method>
  120. <method name="add_attribute_unlocked"><type>std::pair&lt; attribute_set::iterator, bool &gt;</type><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="attr"><paramtype>attribute const &amp;</paramtype></parameter><description><para>Unlocked <computeroutput>add_attribute</computeroutput> </para></description></method>
  121. <method name="remove_attribute_unlocked"><type>void</type><parameter name="it"><paramtype>attribute_set::iterator</paramtype></parameter><description><para>Unlocked <computeroutput>remove_attribute</computeroutput> </para></description></method>
  122. <method name="remove_all_attributes_unlocked"><type>void</type><description><para>Unlocked <computeroutput>remove_all_attributes</computeroutput> </para></description></method>
  123. <method name="open_record_unlocked"><type>record</type><description><para>Unlocked <computeroutput>open_record</computeroutput> </para></description></method>
  124. <method name="open_record_unlocked"><type>record</type><template>
  125. <template-type-parameter name="ArgsT"/>
  126. </template><parameter name=""><paramtype>ArgsT const &amp;</paramtype></parameter><description><para>Unlocked <computeroutput>open_record</computeroutput> </para></description></method>
  127. <method name="push_record_unlocked"><type>void</type><parameter name="rec"><paramtype>record &amp;&amp;</paramtype></parameter><description><para>Unlocked <computeroutput>push_record</computeroutput> </para></description></method>
  128. <method name="get_attributes_unlocked" cv="const"><type>attribute_set</type><description><para>Unlocked <computeroutput>get_attributes</computeroutput> </para></description></method>
  129. <method name="set_attributes_unlocked"><type>void</type><parameter name="attrs"><paramtype>attribute_set const &amp;</paramtype></parameter><description><para>Unlocked <computeroutput>set_attributes</computeroutput> </para></description></method>
  130. </method-group>
  131. <copy-assignment cv="= delete"><type><classname>basic_logger</classname> &amp;</type><parameter name=""><paramtype><classname>basic_logger</classname> const &amp;</paramtype></parameter><purpose>Assignment is closed (should be implemented through copy and swap in the final class) </purpose></copy-assignment>
  132. </class><function name="swap"><type>void</type><template>
  133. <template-type-parameter name="CharT"/>
  134. <template-type-parameter name="FinalT"/>
  135. <template-type-parameter name="ThreadingModelT"/>
  136. </template><parameter name="left"><paramtype><classname>basic_logger</classname>&lt; CharT, FinalT, ThreadingModelT &gt; &amp;</paramtype></parameter><parameter name="right"><paramtype><classname>basic_logger</classname>&lt; CharT, FinalT, ThreadingModelT &gt; &amp;</paramtype></parameter><description><para>Free-standing swap for all loggers </para></description></function>
  137. </namespace>
  138. </namespace>
  139. </namespace>
  140. <macro name="BOOST_LOG_FORWARD_LOGGER_CONSTRUCTORS" kind="functionlike"><macro-parameter name="class_type"/></macro>
  141. <macro name="BOOST_LOG_FORWARD_LOGGER_CONSTRUCTORS_TEMPLATE" kind="functionlike"><macro-parameter name="class_type"/></macro>
  142. <macro name="BOOST_LOG_FORWARD_LOGGER_ASSIGNMENT" kind="functionlike"><macro-parameter name="class_type"/></macro>
  143. <macro name="BOOST_LOG_FORWARD_LOGGER_ASSIGNMENT_TEMPLATE" kind="functionlike"><macro-parameter name="class_type"/></macro>
  144. <macro name="BOOST_LOG_FORWARD_LOGGER_MEMBERS" kind="functionlike"><macro-parameter name="class_type"/></macro>
  145. <macro name="BOOST_LOG_FORWARD_LOGGER_MEMBERS_TEMPLATE" kind="functionlike"><macro-parameter name="class_type"/></macro>
  146. <macro name="BOOST_LOG_DECLARE_LOGGER_TYPE" kind="functionlike"><macro-parameter name="type_name"><description><para>The name of the logger class to declare </para></description></macro-parameter><macro-parameter name="char_type"><description><para>The character type of the logger. Either char or wchar_t expected. </para></description></macro-parameter><macro-parameter name="base_seq"><description><para>A Boost.Preprocessor sequence of type identifiers of the base classes templates </para></description></macro-parameter><macro-parameter name="threading"><description><para>A threading model class </para></description></macro-parameter><purpose>The macro declares a logger class that inherits a number of base classes. </purpose><description><para>
  147. </para></description></macro>
  148. <macro name="BOOST_LOG_DECLARE_LOGGER" kind="functionlike"><macro-parameter name="type_name"><description><para>The name of the logger class to declare </para></description></macro-parameter><macro-parameter name="base_seq"><description><para>A Boost.Preprocessor sequence of type identifiers of the base classes templates </para></description></macro-parameter><purpose>The macro declares a narrow-char logger class that inherits a number of base classes. </purpose><description><para>Equivalent to BOOST_LOG_DECLARE_LOGGER_TYPE(type_name, char, base_seq, single_thread_model)</para><para>
  149. </para></description></macro>
  150. <macro name="BOOST_LOG_DECLARE_LOGGER_MT" kind="functionlike"><macro-parameter name="type_name"><description><para>The name of the logger class to declare </para></description></macro-parameter><macro-parameter name="base_seq"><description><para>A Boost.Preprocessor sequence of type identifiers of the base classes templates </para></description></macro-parameter><purpose>The macro declares a narrow-char thread-safe logger class that inherits a number of base classes. </purpose><description><para>Equivalent to <computeroutput>BOOST_LOG_DECLARE_LOGGER_TYPE(type_name, char, base_seq, multi_thread_model&lt; shared_mutex &gt;)</computeroutput></para><para>
  151. </para></description></macro>
  152. <macro name="BOOST_LOG_DECLARE_WLOGGER" kind="functionlike"><macro-parameter name="type_name"><description><para>The name of the logger class to declare </para></description></macro-parameter><macro-parameter name="base_seq"><description><para>A Boost.Preprocessor sequence of type identifiers of the base classes templates </para></description></macro-parameter><purpose>The macro declares a wide-char logger class that inherits a number of base classes. </purpose><description><para>Equivalent to BOOST_LOG_DECLARE_LOGGER_TYPE(type_name, wchar_t, base_seq, single_thread_model)</para><para>
  153. </para></description></macro>
  154. <macro name="BOOST_LOG_DECLARE_WLOGGER_MT" kind="functionlike"><macro-parameter name="type_name"><description><para>The name of the logger class to declare </para></description></macro-parameter><macro-parameter name="base_seq"><description><para>A Boost.Preprocessor sequence of type identifiers of the base classes templates </para></description></macro-parameter><purpose>The macro declares a wide-char thread-safe logger class that inherits a number of base classes. </purpose><description><para>Equivalent to <computeroutput>BOOST_LOG_DECLARE_LOGGER_TYPE(type_name, wchar_t, base_seq, multi_thread_model&lt; shared_mutex &gt;)</computeroutput></para><para>
  155. </para></description></macro>
  156. </header>
  157. <header name="boost/log/sources/channel_feature.hpp">
  158. <para><para>Andrey Semashev </para>
  159. <para>28.02.2008</para>
  160. The header contains implementation of a channel support feature. </para><namespace name="boost">
  161. <namespace name="log">
  162. <namespace name="sources">
  163. <class name="basic_channel_logger"><template>
  164. <template-type-parameter name="BaseT"/>
  165. <template-type-parameter name="ChannelT"/>
  166. </template><inherit access="public">BaseT</inherit><purpose>Channel feature implementation. </purpose><struct name="make_default_channel_name"><purpose>Default channel name generator. </purpose><typedef name="result_type"><type>channel_type</type></typedef>
  167. <method-group name="public member functions">
  168. <method name="operator()" cv="const"><type>result_type</type></method>
  169. </method-group>
  170. </struct><typedef name="char_type"><purpose>Character type. </purpose><type>base_type::char_type</type></typedef>
  171. <typedef name="final_type"><purpose>Final type. </purpose><type>base_type::final_type</type></typedef>
  172. <typedef name="threading_model"><purpose>Threading model being used. </purpose><type>base_type::threading_model</type></typedef>
  173. <typedef name="channel_type"><purpose>Channel type. </purpose><type>ChannelT</type></typedef>
  174. <typedef name="channel_attribute"><purpose>Channel attribute type. </purpose><type>attributes::mutable_constant&lt; channel_type &gt;</type></typedef>
  175. <typedef name="open_record_lock"><purpose>Lock requirement for the <computeroutput>open_record_unlocked</computeroutput> method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  176. <typedef name="swap_lock"><purpose>Lock requirement for the <computeroutput>swap_unlocked</computeroutput> method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  177. <method-group name="public member functions">
  178. <method name="channel" cv="const"><type>channel_type</type><description><para>The observer of the channel name</para><para>
  179. </para></description><returns><para>The channel name that was set by the logger </para>
  180. </returns></method>
  181. <method name="channel"><type>void</type><parameter name="ch"><paramtype>channel_type const &amp;</paramtype><description><para>The channel name to be set for the logger </para></description></parameter><description><para>The setter of the channel name</para><para>
  182. </para></description></method>
  183. </method-group>
  184. <constructor><description><para>Default constructor. The constructed logger has the default-constructed channel name. </para></description></constructor>
  185. <constructor><parameter name="that"><paramtype><classname>basic_channel_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  186. <constructor><parameter name="that"><paramtype><classname>basic_channel_logger</classname> &amp;&amp;</paramtype></parameter><description><para>Move constructor </para></description></constructor>
  187. <constructor specifiers="explicit"><template>
  188. <template-type-parameter name="ArgsT"/>
  189. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype><description><para>A set of named arguments. The following arguments are supported: <itemizedlist>
  190. <listitem><para><computeroutput>channel</computeroutput> - a string that represents the channel name </para>
  191. </listitem>
  192. </itemizedlist>
  193. </para></description></parameter><description><para>Constructor with arguments. Allows to register a channel name attribute on construction.</para><para>
  194. </para></description></constructor>
  195. <method-group name="protected member functions">
  196. <method name="get_channel_attribute" cv="const"><type>channel_attribute const &amp;</type><description><para>Channel attribute accessor </para></description></method>
  197. <method name="open_record_unlocked"><type>record</type><template>
  198. <template-type-parameter name="ArgsT"/>
  199. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter><description><para>Unlocked <computeroutput>open_record</computeroutput> </para></description></method>
  200. <method name="swap_unlocked"><type>void</type><parameter name="that"><paramtype><classname>basic_channel_logger</classname> &amp;</paramtype></parameter><description><para>Unlocked swap </para></description></method>
  201. </method-group>
  202. <method-group name="private member functions">
  203. <method name="open_record_with_channel_unlocked"><type>record</type><template>
  204. <template-type-parameter name="ArgsT"/>
  205. <template-type-parameter name="T"/>
  206. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter><parameter name="ch"><paramtype>T const &amp;</paramtype></parameter><purpose>The <computeroutput>open_record</computeroutput> implementation for the case when the channel is specified in log statement. </purpose></method>
  207. <method name="open_record_with_channel_unlocked"><type>record</type><template>
  208. <template-type-parameter name="ArgsT"/>
  209. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter><parameter name=""><paramtype>parameter::void_</paramtype></parameter><purpose>The <computeroutput>open_record</computeroutput> implementation for the case when the channel is not specified in log statement. </purpose></method>
  210. </method-group>
  211. </class><struct name="channel"><template>
  212. <template-type-parameter name="ChannelT"><default>std::string</default></template-type-parameter>
  213. </template><purpose>Channel support feature. </purpose><description><para>The logger with this feature automatically registers an attribute with the specified on construction value, which is a channel name. The channel name can be modified through the logger life time, either by calling the <computeroutput>channel</computeroutput> method or by specifying the name in the logging statement.</para><para>The type of the channel name can be customized by providing it as a template parameter to the feature template. By default, a string will be used. </para></description><struct name="apply"><template>
  214. <template-type-parameter name="BaseT"/>
  215. </template><typedef name="type"><type><classname>basic_channel_logger</classname>&lt; BaseT, ChannelT &gt;</type></typedef>
  216. </struct></struct>
  217. </namespace>
  218. </namespace>
  219. </namespace>
  220. <macro name="BOOST_LOG_STREAM_CHANNEL" kind="functionlike"><macro-parameter name="logger"/><macro-parameter name="chan"/><purpose>The macro allows to put a record with a specific channel name into log. </purpose></macro>
  221. <macro name="BOOST_LOG_CHANNEL" kind="functionlike"><macro-parameter name="logger"/><macro-parameter name="chan"/><purpose>An equivalent to BOOST_LOG_STREAM_CHANNEL(logger, chan) </purpose></macro>
  222. </header>
  223. <header name="boost/log/sources/channel_logger.hpp">
  224. <para><para>Andrey Semashev </para>
  225. <para>28.02.2008</para>
  226. The header contains implementation of a logger with channel support. </para><namespace name="boost">
  227. <namespace name="log">
  228. <namespace name="sources">
  229. <class name="channel_logger"><template>
  230. <template-type-parameter name="ChannelT"><default>std::string</default></template-type-parameter>
  231. </template><inherit access="public">basic_composite_logger&lt; char, channel_logger&lt; ChannelT &gt;, single_thread_model, features&lt; channel&lt; ChannelT &gt; &gt; &gt;</inherit><purpose>Narrow-char logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_channel_logger">basic_channel_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>channel</computeroutput> class template for a more detailed description </para></description><method-group name="public member functions">
  232. </method-group>
  233. <constructor><description><para>Default constructor </para></description></constructor>
  234. <constructor><parameter name="that"><paramtype><classname>channel_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  235. <constructor specifiers="explicit"><template>
  236. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  237. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  238. <constructor specifiers="explicit"><parameter name="channel"><paramtype>ChannelT const &amp;</paramtype><description><para>The channel name </para></description></parameter><description><para>The constructor creates the logger with the specified channel name</para><para>
  239. </para></description></constructor>
  240. <copy-assignment><type><classname>channel_logger</classname> &amp;</type><parameter name="that"><paramtype><classname>channel_logger</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  241. </class><class name="channel_logger_mt"><template>
  242. <template-type-parameter name="ChannelT"><default>std::string</default></template-type-parameter>
  243. </template><inherit access="public">basic_composite_logger&lt; char, channel_logger_mt&lt; ChannelT &gt;, multi_thread_model&lt; implementation_defined &gt;, features&lt; channel&lt; ChannelT &gt; &gt; &gt;</inherit><purpose>Narrow-char thread-safe logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_channel_logger">basic_channel_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>channel</computeroutput> class template for a more detailed description </para></description><method-group name="public member functions">
  244. </method-group>
  245. <constructor><description><para>Default constructor </para></description></constructor>
  246. <constructor><parameter name="that"><paramtype><classname>channel_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  247. <constructor specifiers="explicit"><template>
  248. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  249. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  250. <constructor specifiers="explicit"><parameter name="channel"><paramtype>ChannelT const &amp;</paramtype><description><para>The channel name </para></description></parameter><description><para>The constructor creates the logger with the specified channel name</para><para>
  251. </para></description></constructor>
  252. <copy-assignment><type><classname>channel_logger_mt</classname> &amp;</type><parameter name="that"><paramtype><classname>channel_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  253. </class><class name="wchannel_logger"><template>
  254. <template-type-parameter name="ChannelT"><default>std::wstring</default></template-type-parameter>
  255. </template><inherit access="public">basic_composite_logger&lt; wchar_t, wchannel_logger&lt; ChannelT &gt;, single_thread_model, features&lt; channel&lt; ChannelT &gt; &gt; &gt;</inherit><purpose>Wide-char logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_channel_logger">basic_channel_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>channel</computeroutput> class template for a more detailed description </para></description><method-group name="public member functions">
  256. </method-group>
  257. <constructor><description><para>Default constructor </para></description></constructor>
  258. <constructor><parameter name="that"><paramtype><classname>wchannel_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  259. <constructor specifiers="explicit"><template>
  260. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  261. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  262. <constructor specifiers="explicit"><parameter name="channel"><paramtype>ChannelT const &amp;</paramtype><description><para>The channel name </para></description></parameter><description><para>The constructor creates the logger with the specified channel name</para><para>
  263. </para></description></constructor>
  264. <copy-assignment><type><classname>wchannel_logger</classname> &amp;</type><parameter name="that"><paramtype><classname>wchannel_logger</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  265. </class><class name="wchannel_logger_mt"><template>
  266. <template-type-parameter name="ChannelT"><default>std::wstring</default></template-type-parameter>
  267. </template><inherit access="public">basic_composite_logger&lt; wchar_t, wchannel_logger&lt; ChannelT &gt;, multi_thread_model&lt; implementation_defined &gt;, features&lt; channel&lt; ChannelT &gt; &gt; &gt;</inherit><purpose>Wide-char thread-safe logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_channel_logger">basic_channel_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>channel</computeroutput> class template for a more detailed description </para></description><method-group name="public member functions">
  268. </method-group>
  269. <constructor><description><para>Default constructor </para></description></constructor>
  270. <constructor><parameter name="that"><paramtype><classname>wchannel_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  271. <constructor specifiers="explicit"><template>
  272. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  273. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  274. <constructor specifiers="explicit"><parameter name="channel"><paramtype>ChannelT const &amp;</paramtype><description><para>The channel name </para></description></parameter><description><para>The constructor creates the logger with the specified channel name</para><para>
  275. </para></description></constructor>
  276. <copy-assignment><type><classname>wchannel_logger_mt</classname> &amp;</type><parameter name="that"><paramtype><classname>wchannel_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  277. </class>
  278. </namespace>
  279. </namespace>
  280. </namespace>
  281. </header>
  282. <header name="boost/log/sources/exception_handler_feature.hpp">
  283. <para><para>Andrey Semashev </para>
  284. <para>17.07.2009</para>
  285. The header contains implementation of an exception handler support feature. </para><namespace name="boost">
  286. <namespace name="log">
  287. <namespace name="sources">
  288. <class name="basic_exception_handler_logger"><template>
  289. <template-type-parameter name="BaseT"/>
  290. </template><inherit access="public">BaseT</inherit><purpose>Exception handler feature implementation. </purpose><typedef name="threading_model"><purpose>Threading model being used. </purpose><type>base_type::threading_model</type></typedef>
  291. <typedef name="final_type"><purpose>Final logger type. </purpose><type>base_type::final_type</type></typedef>
  292. <typedef name="exception_handler_type"><purpose>Exception handler function type. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  293. <typedef name="open_record_lock"><purpose>Lock requirement for the open_record_unlocked method. </purpose><type>strictest_lock&lt; typename base_type::open_record_lock, no_lock&lt; threading_model &gt; &gt;::type</type></typedef>
  294. <typedef name="push_record_lock"><purpose>Lock requirement for the push_record_unlocked method. </purpose><type>strictest_lock&lt; typename base_type::push_record_lock, no_lock&lt; threading_model &gt; &gt;::type</type></typedef>
  295. <typedef name="swap_lock"><purpose>Lock requirement for the swap_unlocked method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  296. <method-group name="public member functions">
  297. <method name="set_exception_handler"><type>void</type><template>
  298. <template-type-parameter name="HandlerT"/>
  299. </template><parameter name="handler"><paramtype>HandlerT const &amp;</paramtype><description><para>Exception handling function</para></description></parameter><description><para>The method sets exception handler function. The function will be called with no arguments in case if an exception occurs during either <computeroutput>open_record</computeroutput> or <computeroutput>push_record</computeroutput> method execution. Since exception handler is called from a <computeroutput>catch</computeroutput> statement, the exception can be rethrown in order to determine its type.</para><para>By default no handler is installed, thus any exception is propagated as usual.</para><para><para><emphasis role="bold">See Also:</emphasis><para><computeroutput>utility/exception_handler.hpp</computeroutput> </para>
  300. </para>
  301. <note><para>The exception handler can be invoked in several threads concurrently.</para>
  302. </note>
  303. <note><para>Thread interruptions are not affected by exception handlers. </para>
  304. </note>
  305. </para></description></method>
  306. </method-group>
  307. <constructor><description><para>Default constructor. The constructed logger does not have an exception handler. </para></description></constructor>
  308. <constructor><parameter name="that"><paramtype><classname>basic_exception_handler_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  309. <constructor><parameter name="that"><paramtype><classname>basic_exception_handler_logger</classname> &amp;&amp;</paramtype></parameter><description><para>Move constructor </para></description></constructor>
  310. <constructor specifiers="explicit"><template>
  311. <template-type-parameter name="ArgsT"/>
  312. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter><description><para>Constructor with arguments. Passes arguments to other features. </para></description></constructor>
  313. <method-group name="protected member functions">
  314. <method name="open_record_unlocked"><type>record</type><template>
  315. <template-type-parameter name="ArgsT"/>
  316. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter><description><para>Unlocked <computeroutput>open_record</computeroutput> </para></description></method>
  317. <method name="push_record_unlocked"><type>void</type><parameter name="rec"><paramtype>record &amp;&amp;</paramtype></parameter><description><para>Unlocked <computeroutput>push_record</computeroutput> </para></description></method>
  318. <method name="swap_unlocked"><type>void</type><parameter name="that"><paramtype><classname>basic_exception_handler_logger</classname> &amp;</paramtype></parameter><description><para>Unlocked swap </para></description></method>
  319. </method-group>
  320. </class><struct name="exception_handler"><purpose>Exception handler support feature. </purpose><description><para>The logger with this feature will provide an additional method to install an exception handler functional object. This functional object will be called if during either opening or pushing a record an exception is thrown from the logging core. </para></description><struct name="apply"><template>
  321. <template-type-parameter name="BaseT"/>
  322. </template><typedef name="type"><type><classname>basic_exception_handler_logger</classname>&lt; BaseT &gt;</type></typedef>
  323. </struct></struct>
  324. </namespace>
  325. </namespace>
  326. </namespace>
  327. </header>
  328. <header name="boost/log/sources/features.hpp">
  329. <para><para>Andrey Semashev </para>
  330. <para>17.07.2009</para>
  331. The header contains definition of a features list class template. </para><namespace name="boost">
  332. <namespace name="log">
  333. <namespace name="sources">
  334. <struct name="features"><template>
  335. <template-nontype-parameter name="FeaturesT"><type>typename...</type></template-nontype-parameter>
  336. </template><purpose>A type sequence of logger features. </purpose><description><para>This class template can be used to specify logger features in a <computeroutput><classname alt="boost::log::sources::basic_composite_logger">basic_composite_logger</classname></computeroutput> instantiation. </para></description></struct>
  337. </namespace>
  338. </namespace>
  339. </namespace>
  340. </header>
  341. <header name="boost/log/sources/global_logger_storage.hpp">
  342. <para><para>Andrey Semashev </para>
  343. <para>21.04.2008</para>
  344. The header contains implementation of facilities to declare global loggers. </para><namespace name="boost">
  345. <namespace name="log">
  346. <namespace name="sources">
  347. </namespace>
  348. </namespace>
  349. </namespace>
  350. <macro name="BOOST_LOG_GLOBAL_LOGGER" kind="functionlike"><macro-parameter name="tag_name"/><macro-parameter name="logger"/><purpose>The macro forward-declares a global logger with a custom initialization. </purpose></macro>
  351. <macro name="BOOST_LOG_GLOBAL_LOGGER_INIT" kind="functionlike"><macro-parameter name="tag_name"/><macro-parameter name="logger"/><purpose>The macro defines a global logger initialization routine. </purpose></macro>
  352. <macro name="BOOST_LOG_GLOBAL_LOGGER_DEFAULT" kind="functionlike"><macro-parameter name="tag_name"/><macro-parameter name="logger"/><purpose>The macro defines a global logger initializer that will default-construct the logger. </purpose></macro>
  353. <macro name="BOOST_LOG_GLOBAL_LOGGER_CTOR_ARGS" kind="functionlike"><macro-parameter name="tag_name"/><macro-parameter name="logger"/><macro-parameter name="args"/><purpose>The macro defines a global logger initializer that will construct the logger with the specified constructor arguments. </purpose></macro>
  354. <macro name="BOOST_LOG_INLINE_GLOBAL_LOGGER_INIT" kind="functionlike"><macro-parameter name="tag_name"/><macro-parameter name="logger"/><purpose>The macro declares a global logger with a custom initialization. </purpose></macro>
  355. <macro name="BOOST_LOG_INLINE_GLOBAL_LOGGER_DEFAULT" kind="functionlike"><macro-parameter name="tag_name"/><macro-parameter name="logger"/><purpose>The macro declares a global logger that will be default-constructed. </purpose></macro>
  356. <macro name="BOOST_LOG_INLINE_GLOBAL_LOGGER_CTOR_ARGS" kind="functionlike"><macro-parameter name="tag_name"/><macro-parameter name="logger"/><macro-parameter name="args"/><purpose>The macro declares a global logger that will be constructed with the specified arguments. </purpose></macro>
  357. </header>
  358. <header name="boost/log/sources/logger.hpp">
  359. <para><para>Andrey Semashev </para>
  360. <para>08.03.2007</para>
  361. The header contains implementation of a simplistic logger with no features. </para><namespace name="boost">
  362. <namespace name="log">
  363. <namespace name="sources">
  364. <class name="logger"><inherit access="public">basic_composite_logger&lt; char, logger, single_thread_model, features&lt; &gt; &gt;</inherit><purpose>Narrow-char logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput> class template for a more detailed description. </para></description></class><class name="logger_mt"><purpose>Narrow-char thread-safe logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput> class template for a more detailed description. </para></description></class><class name="wlogger"><inherit access="public">basic_composite_logger&lt; wchar_t, wlogger, single_thread_model, features&lt; &gt; &gt;</inherit><purpose>Wide-char logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput> class template for a more detailed description. </para></description></class><class name="wlogger_mt"><purpose>Wide-char thread-safe logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput><classname alt="boost::log::sources::basic_logger">basic_logger</classname></computeroutput> class template for a more detailed description. </para></description></class>
  365. </namespace>
  366. </namespace>
  367. </namespace>
  368. </header>
  369. <header name="boost/log/sources/record_ostream.hpp">
  370. <para><para>Andrey Semashev </para>
  371. <para>09.03.2009</para>
  372. This header contains a wrapper class around a logging record that allows to compose the record message with a streaming expression. </para><namespace name="boost">
  373. <namespace name="log">
  374. <class name="basic_record_ostream"><template>
  375. <template-type-parameter name="CharT"/>
  376. </template><inherit access="public">basic_formatting_ostream&lt; CharT &gt;</inherit><purpose>Logging record adapter with a streaming capability. </purpose><description><para>This class allows to compose the logging record message by streaming operations. It aggregates the log record and provides the standard output stream interface. </para></description><typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  377. <typedef name="string_type"><purpose>String type to be used as a message text holder. </purpose><type>std::basic_string&lt; char_type &gt;</type></typedef>
  378. <typedef name="stream_type"><purpose>Stream type. </purpose><type>std::basic_ostream&lt; char_type &gt;</type></typedef>
  379. <typedef name="traits_type"><purpose>Character traits. </purpose><type>base_type::traits_type</type></typedef>
  380. <method-group name="public member functions">
  381. <method name="conversion-operator" cv="const noexcept" specifiers="explicit"><type>bool</type><description><para>Conversion to an unspecified boolean type</para><para>
  382. </para></description><returns><para><computeroutput>true</computeroutput>, if stream is valid and ready for formatting, <computeroutput>false</computeroutput>, if the stream is not valid. The latter also applies to the case when the stream is not attached to a log record. </para>
  383. </returns></method>
  384. <method name="operator!" cv="const noexcept"><type>bool</type><description><para>Inverted conversion to an unspecified boolean type</para><para>
  385. </para></description><returns><para><computeroutput>false</computeroutput>, if stream is valid and ready for formatting, <computeroutput>true</computeroutput>, if the stream is not valid. The latter also applies to the case when the stream is not attached to a log record. </para>
  386. </returns></method>
  387. <method name="get_record"><type>record &amp;</type><description><para>Flushes internal buffers to complete all pending formatting operations and returns the aggregated log record</para><para>
  388. </para></description><returns><para>The aggregated record object </para>
  389. </returns></method>
  390. <method name="get_record" cv="const"><type>record const &amp;</type><description><para>Flushes internal buffers to complete all pending formatting operations and returns the aggregated log record</para><para>
  391. </para></description><returns><para>The aggregated record object </para>
  392. </returns></method>
  393. <method name="attach_record"><type>void</type><parameter name="rec"><paramtype>record &amp;</paramtype><description><para>New log record to attach to </para></description></parameter><description><para>If the stream is attached to a log record, flushes internal buffers to complete all pending formatting operations. Then reattaches the stream to another log record.</para><para>
  394. </para></description></method>
  395. <method name="detach_from_record" cv="noexcept"><type>void</type><purpose>The function resets the stream into a detached (default initialized) state. </purpose></method>
  396. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="manip"><paramtype>typename base_type::ios_base_manip</paramtype></parameter></method>
  397. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="manip"><paramtype>typename base_type::basic_ios_manip</paramtype></parameter></method>
  398. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="manip"><paramtype>typename base_type::stream_manip</paramtype></parameter></method>
  399. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="c"><paramtype>char</paramtype></parameter></method>
  400. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="p"><paramtype>const char *</paramtype></parameter></method>
  401. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="c"><paramtype>wchar_t</paramtype></parameter></method>
  402. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="p"><paramtype>const wchar_t *</paramtype></parameter></method>
  403. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="c"><paramtype>char16_t</paramtype></parameter></method>
  404. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="p"><paramtype>const char16_t *</paramtype></parameter></method>
  405. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="c"><paramtype>char32_t</paramtype></parameter></method>
  406. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="p"><paramtype>const char32_t *</paramtype></parameter></method>
  407. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>bool</paramtype></parameter></method>
  408. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>signed char</paramtype></parameter></method>
  409. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>unsigned char</paramtype></parameter></method>
  410. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>short</paramtype></parameter></method>
  411. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>unsigned short</paramtype></parameter></method>
  412. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>int</paramtype></parameter></method>
  413. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>unsigned int</paramtype></parameter></method>
  414. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>long</paramtype></parameter></method>
  415. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>unsigned long</paramtype></parameter></method>
  416. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>long long</paramtype></parameter></method>
  417. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>unsigned long long</paramtype></parameter></method>
  418. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>float</paramtype></parameter></method>
  419. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>double</paramtype></parameter></method>
  420. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="value"><paramtype>long double</paramtype></parameter></method>
  421. <method name="operator&lt;&lt;"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name="buf"><paramtype>std::basic_streambuf&lt; char_type, traits_type &gt; *</paramtype></parameter></method>
  422. </method-group>
  423. <constructor cv="noexcept"><description><para>Default constructor. Creates an empty record that is equivalent to the invalid record handle. The stream capability is not available after construction.</para><para>
  424. </para></description><postconditions><para><computeroutput>!*this == true</computeroutput> </para>
  425. </postconditions></constructor>
  426. <constructor specifiers="explicit"><parameter name="rec"><paramtype>record &amp;</paramtype><description><para>The record handle being attached to </para></description></parameter><description><para>Constructor from a record object. Attaches to the provided record.</para><para>
  427. </para></description><requires><para><computeroutput>!!rec == true</computeroutput> </para>
  428. </requires><postconditions><para><computeroutput>&amp;this-&gt;get_record() == &amp;rec</computeroutput> </para>
  429. </postconditions></constructor>
  430. <destructor><description><para>Destructor. Destroys the record, releases any sinks and attribute values that were involved in processing this record. </para></description></destructor>
  431. <method-group name="private member functions">
  432. <method name="init_stream"><type>void</type><purpose>The function initializes the stream and the stream buffer. </purpose></method>
  433. </method-group>
  434. <constructor cv="= delete"><parameter name=""><paramtype><classname>basic_record_ostream</classname> const &amp;</paramtype></parameter></constructor>
  435. <copy-assignment cv="= delete"><type><classname>basic_record_ostream</classname> &amp;</type><parameter name=""><paramtype><classname>basic_record_ostream</classname> const &amp;</paramtype></parameter></copy-assignment>
  436. </class><typedef name="record_ostream"><purpose>Convenience typedef for narrow-character logging. </purpose><type><classname>basic_record_ostream</classname>&lt; char &gt;</type></typedef>
  437. <typedef name="wrecord_ostream"><purpose>Convenience typedef for wide-character logging. </purpose><type><classname>basic_record_ostream</classname>&lt; wchar_t &gt;</type></typedef>
  438. <function name="operator&lt;&lt;"><type><emphasis>unspecified</emphasis></type><template>
  439. <template-type-parameter name="StreamT"/>
  440. <template-type-parameter name="T"/>
  441. </template><parameter name="strm"><paramtype>StreamT &amp;</paramtype></parameter><parameter name="value"><paramtype>T</paramtype></parameter></function>
  442. <function name="operator&lt;&lt;"><type><emphasis>unspecified</emphasis></type><template>
  443. <template-type-parameter name="StreamT"/>
  444. <template-type-parameter name="T"/>
  445. </template><parameter name="strm"><paramtype>StreamT &amp;</paramtype></parameter><parameter name="value"><paramtype>T const &amp;</paramtype></parameter></function>
  446. <function name="operator&lt;&lt;"><type><emphasis>unspecified</emphasis></type><template>
  447. <template-type-parameter name="StreamT"/>
  448. <template-type-parameter name="T"/>
  449. </template><parameter name="strm"><paramtype>StreamT &amp;</paramtype></parameter><parameter name="value"><paramtype>T &amp;</paramtype></parameter></function>
  450. <function name="operator&lt;&lt;"><type><emphasis>unspecified</emphasis></type><template>
  451. <template-type-parameter name="StreamT"/>
  452. <template-type-parameter name="T"/>
  453. </template><parameter name="strm"><paramtype>StreamT &amp;&amp;</paramtype></parameter><parameter name="value"><paramtype>T</paramtype></parameter></function>
  454. <function name="operator&lt;&lt;"><type><emphasis>unspecified</emphasis></type><template>
  455. <template-type-parameter name="StreamT"/>
  456. <template-type-parameter name="T"/>
  457. </template><parameter name="strm"><paramtype>StreamT &amp;&amp;</paramtype></parameter><parameter name="value"><paramtype>T const &amp;</paramtype></parameter></function>
  458. <function name="operator&lt;&lt;"><type><emphasis>unspecified</emphasis></type><template>
  459. <template-type-parameter name="StreamT"/>
  460. <template-type-parameter name="T"/>
  461. </template><parameter name="strm"><paramtype>StreamT &amp;&amp;</paramtype></parameter><parameter name="value"><paramtype>T &amp;</paramtype></parameter></function>
  462. </namespace>
  463. </namespace>
  464. <macro name="BOOST_LOG_STREAM" kind="functionlike"><macro-parameter name="logger"/><purpose>The macro writes a record to the log. </purpose></macro>
  465. <macro name="BOOST_LOG_STREAM_WITH_PARAMS" kind="functionlike"><macro-parameter name="logger"/><macro-parameter name="params_seq"/><purpose>The macro writes a record to the log and allows to pass additional named arguments to the logger. </purpose></macro>
  466. <macro name="BOOST_LOG" kind="functionlike"><macro-parameter name="logger"/><purpose>An equivalent to BOOST_LOG_STREAM(logger) </purpose></macro>
  467. <macro name="BOOST_LOG_WITH_PARAMS" kind="functionlike"><macro-parameter name="logger"/><macro-parameter name="params_seq"/><purpose>An equivalent to BOOST_LOG_STREAM_WITH_PARAMS(logger, params_seq) </purpose></macro>
  468. </header>
  469. <header name="boost/log/sources/severity_channel_logger.hpp">
  470. <para><para>Andrey Semashev </para>
  471. <para>28.02.2008</para>
  472. The header contains implementation of a logger with severity level and channel support. </para><namespace name="boost">
  473. <namespace name="log">
  474. <namespace name="sources">
  475. <class name="severity_channel_logger"><template>
  476. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  477. <template-type-parameter name="ChannelT"><default>std::string</default></template-type-parameter>
  478. </template><inherit access="public">basic_composite_logger&lt; char, severity_channel_logger&lt; LevelT, ChannelT &gt;, single_thread_model, features&lt; severity&lt; LevelT &gt;, channel&lt; ChannelT &gt; &gt; &gt;</inherit><purpose>Narrow-char logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_severity_logger">basic_severity_logger</classname></computeroutput> and <computeroutput><classname alt="boost::log::sources::basic_channel_logger">basic_channel_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>severity</computeroutput> and <computeroutput>channel</computeroutput> class templates for a more detailed description </para></description><method-group name="public member functions">
  479. </method-group>
  480. <constructor><description><para>Default constructor </para></description></constructor>
  481. <constructor><parameter name="that"><paramtype><classname>severity_channel_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  482. <constructor specifiers="explicit"><template>
  483. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  484. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  485. <copy-assignment><type><classname>severity_channel_logger</classname> &amp;</type><parameter name="that"><paramtype><classname>severity_channel_logger</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  486. </class><class name="severity_channel_logger_mt"><template>
  487. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  488. <template-type-parameter name="ChannelT"><default>std::string</default></template-type-parameter>
  489. </template><inherit access="public">basic_composite_logger&lt; char, severity_channel_logger_mt&lt; LevelT, ChannelT &gt;, multi_thread_model&lt; implementation_defined &gt;, features&lt; severity&lt; LevelT &gt;, channel&lt; ChannelT &gt; &gt; &gt;</inherit><purpose>Narrow-char thread-safe logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_severity_logger">basic_severity_logger</classname></computeroutput> and <computeroutput><classname alt="boost::log::sources::basic_channel_logger">basic_channel_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>severity</computeroutput> and <computeroutput>channel</computeroutput> class templates for a more detailed description </para></description><method-group name="public member functions">
  490. </method-group>
  491. <constructor><description><para>Default constructor </para></description></constructor>
  492. <constructor><parameter name="that"><paramtype><classname>severity_channel_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  493. <constructor specifiers="explicit"><template>
  494. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  495. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  496. <copy-assignment><type><classname>severity_channel_logger_mt</classname> &amp;</type><parameter name="that"><paramtype><classname>severity_channel_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  497. </class><class name="wseverity_channel_logger"><template>
  498. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  499. <template-type-parameter name="ChannelT"><default>std::wstring</default></template-type-parameter>
  500. </template><inherit access="public">basic_composite_logger&lt; wchar_t, wseverity_channel_logger&lt; LevelT, ChannelT &gt;, single_thread_model, features&lt; severity&lt; LevelT &gt;, channel&lt; ChannelT &gt; &gt; &gt;</inherit><purpose>Wide-char logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_severity_logger">basic_severity_logger</classname></computeroutput> and <computeroutput><classname alt="boost::log::sources::basic_channel_logger">basic_channel_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>severity</computeroutput> and <computeroutput>channel</computeroutput> class templates for a more detailed description </para></description><method-group name="public member functions">
  501. </method-group>
  502. <constructor><description><para>Default constructor </para></description></constructor>
  503. <constructor><parameter name="that"><paramtype><classname>wseverity_channel_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  504. <constructor specifiers="explicit"><template>
  505. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  506. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  507. <copy-assignment><type><classname>wseverity_channel_logger</classname> &amp;</type><parameter name="that"><paramtype><classname>wseverity_channel_logger</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  508. </class><class name="wseverity_channel_logger_mt"><template>
  509. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  510. <template-type-parameter name="ChannelT"><default>std::wstring</default></template-type-parameter>
  511. </template><inherit access="public">basic_composite_logger&lt; wchar_t, wseverity_channel_logger_mt&lt; LevelT, ChannelT &gt;, multi_thread_model&lt; implementation_defined &gt;, features&lt; severity&lt; LevelT &gt;, channel&lt; ChannelT &gt; &gt; &gt;</inherit><purpose>Wide-char thread-safe logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_severity_logger">basic_severity_logger</classname></computeroutput> and <computeroutput><classname alt="boost::log::sources::basic_channel_logger">basic_channel_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>severity</computeroutput> and <computeroutput>channel</computeroutput> class templates for a more detailed description </para></description><method-group name="public member functions">
  512. </method-group>
  513. <constructor><description><para>Default constructor </para></description></constructor>
  514. <constructor><parameter name="that"><paramtype><classname>wseverity_channel_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  515. <constructor specifiers="explicit"><template>
  516. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  517. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  518. <copy-assignment><type><classname>wseverity_channel_logger_mt</classname> &amp;</type><parameter name="that"><paramtype><classname>wseverity_channel_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  519. </class>
  520. </namespace>
  521. </namespace>
  522. </namespace>
  523. <macro name="BOOST_LOG_STREAM_CHANNEL_SEV" kind="functionlike"><macro-parameter name="logger"/><macro-parameter name="chan"/><macro-parameter name="lvl"/><purpose>The macro allows to put a record with a specific channel name into log. </purpose></macro>
  524. <macro name="BOOST_LOG_CHANNEL_SEV" kind="functionlike"><macro-parameter name="logger"/><macro-parameter name="chan"/><macro-parameter name="lvl"/><purpose>An equivalent to BOOST_LOG_STREAM_CHANNEL_SEV(logger, chan, lvl) </purpose></macro>
  525. </header>
  526. <header name="boost/log/sources/severity_feature.hpp">
  527. <para><para>Andrey Semashev </para>
  528. <para>08.03.2007</para>
  529. The header contains implementation of a severity level support feature. </para><namespace name="boost">
  530. <namespace name="log">
  531. <namespace name="sources">
  532. <class name="basic_severity_logger"><template>
  533. <template-type-parameter name="BaseT"/>
  534. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  535. </template><inherit access="public">BaseT</inherit><purpose>Severity level feature implementation. </purpose><typedef name="char_type"><purpose>Character type. </purpose><type>base_type::char_type</type></typedef>
  536. <typedef name="final_type"><purpose>Final type. </purpose><type>base_type::final_type</type></typedef>
  537. <typedef name="threading_model"><purpose>Threading model being used. </purpose><type>base_type::threading_model</type></typedef>
  538. <typedef name="severity_level"><purpose>Severity level type. </purpose><type>LevelT</type></typedef>
  539. <typedef name="severity_attribute"><purpose>Severity attribute type. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  540. <typedef name="open_record_lock"><purpose>Lock requirement for the <computeroutput>open_record_unlocked</computeroutput> method. </purpose><type>strictest_lock&lt; typename base_type::open_record_lock, no_lock&lt; threading_model &gt; &gt;::type</type></typedef>
  541. <typedef name="swap_lock"><purpose>Lock requirement for the <computeroutput>swap_unlocked</computeroutput> method. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  542. <method-group name="public member functions">
  543. <method name="default_severity" cv="const"><type>severity_level</type><description><para>Default severity value getter </para></description></method>
  544. </method-group>
  545. <constructor><description><para>Default constructor. The constructed logger will have a severity attribute registered. The default level for log records will be 0. </para></description></constructor>
  546. <constructor><parameter name="that"><paramtype><classname>basic_severity_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  547. <constructor><parameter name="that"><paramtype><classname>basic_severity_logger</classname> &amp;&amp;</paramtype></parameter><description><para>Move constructor </para></description></constructor>
  548. <constructor specifiers="explicit"><template>
  549. <template-type-parameter name="ArgsT"/>
  550. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype><description><para>A set of named arguments. The following arguments are supported: <itemizedlist>
  551. <listitem><para><computeroutput>severity</computeroutput> - default severity value </para>
  552. </listitem>
  553. </itemizedlist>
  554. </para></description></parameter><description><para>Constructor with named arguments. Allows to setup the default level for log records.</para><para>
  555. </para></description></constructor>
  556. <method-group name="protected member functions">
  557. <method name="get_severity_attribute" cv="const"><type>severity_attribute const &amp;</type><description><para>Severity attribute accessor </para></description></method>
  558. <method name="open_record_unlocked"><type>record</type><template>
  559. <template-type-parameter name="ArgsT"/>
  560. </template><parameter name="args"><paramtype>ArgsT const &amp;</paramtype></parameter><description><para>Unlocked <computeroutput>open_record</computeroutput> </para></description></method>
  561. <method name="swap_unlocked"><type>void</type><parameter name="that"><paramtype><classname>basic_severity_logger</classname> &amp;</paramtype></parameter><purpose>Unlocked <computeroutput>swap</computeroutput>. </purpose></method>
  562. </method-group>
  563. </class><struct name="severity"><template>
  564. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  565. </template><purpose>Severity level support feature. </purpose><description><para>The logger with this feature registers a special attribute with an integral value type on construction. This attribute will provide severity level for each log record being made through the logger. The severity level can be omitted on logging record construction, in which case the default level will be used. The default level can also be customized by passing it to the logger constructor.</para><para>The type of the severity level attribute can be specified as a template parameter for the feature template. By default, <computeroutput>int</computeroutput> will be used. </para></description><struct name="apply"><template>
  566. <template-type-parameter name="BaseT"/>
  567. </template><typedef name="type"><type><classname>basic_severity_logger</classname>&lt; BaseT, LevelT &gt;</type></typedef>
  568. </struct></struct>
  569. </namespace>
  570. </namespace>
  571. </namespace>
  572. <macro name="BOOST_LOG_STREAM_SEV" kind="functionlike"><macro-parameter name="logger"/><macro-parameter name="lvl"/><purpose>The macro allows to put a record with a specific severity level into log. </purpose></macro>
  573. <macro name="BOOST_LOG_SEV" kind="functionlike"><macro-parameter name="logger"/><macro-parameter name="lvl"/><purpose>An equivalent to BOOST_LOG_STREAM_SEV(logger, lvl) </purpose></macro>
  574. </header>
  575. <header name="boost/log/sources/severity_logger.hpp">
  576. <para><para>Andrey Semashev </para>
  577. <para>08.03.2007</para>
  578. The header contains implementation of a logger with severity level support. </para><namespace name="boost">
  579. <namespace name="log">
  580. <namespace name="sources">
  581. <class name="severity_logger"><template>
  582. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  583. </template><inherit access="public">basic_composite_logger&lt; char, severity_logger&lt; LevelT &gt;, single_thread_model, features&lt; severity&lt; LevelT &gt; &gt; &gt;</inherit><purpose>Narrow-char logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_severity_logger">basic_severity_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>severity</computeroutput> class template for a more detailed description </para></description><method-group name="public member functions">
  584. </method-group>
  585. <constructor><description><para>Default constructor </para></description></constructor>
  586. <constructor><parameter name="that"><paramtype><classname>severity_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  587. <constructor specifiers="explicit"><template>
  588. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  589. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  590. <constructor specifiers="explicit"><parameter name="level"><paramtype>LevelT</paramtype><description><para>The default severity level </para></description></parameter><description><para>The constructor creates the logger with the specified default severity level</para><para>
  591. </para></description></constructor>
  592. <copy-assignment><type><classname>severity_logger</classname> &amp;</type><parameter name="that"><paramtype><classname>severity_logger</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  593. </class><class name="severity_logger_mt"><template>
  594. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  595. </template><inherit access="public">basic_composite_logger&lt; char, severity_logger_mt&lt; LevelT &gt;, multi_thread_model&lt; implementation_defined &gt;, features&lt; severity&lt; LevelT &gt; &gt; &gt;</inherit><purpose>Narrow-char thread-safe logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_severity_logger">basic_severity_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>severity</computeroutput> class template for a more detailed description </para></description><method-group name="public member functions">
  596. </method-group>
  597. <constructor><description><para>Default constructor </para></description></constructor>
  598. <constructor><parameter name="that"><paramtype><classname>severity_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  599. <constructor specifiers="explicit"><template>
  600. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  601. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  602. <constructor specifiers="explicit"><parameter name="level"><paramtype>LevelT</paramtype><description><para>The default severity level </para></description></parameter><description><para>The constructor creates the logger with the specified default severity level</para><para>
  603. </para></description></constructor>
  604. <copy-assignment><type><classname>severity_logger_mt</classname> &amp;</type><parameter name="that"><paramtype><classname>severity_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  605. </class><class name="wseverity_logger"><template>
  606. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  607. </template><inherit access="public">basic_composite_logger&lt; wchar_t, wseverity_logger&lt; LevelT &gt;, single_thread_model, features&lt; severity&lt; LevelT &gt; &gt; &gt;</inherit><purpose>Wide-char logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_severity_logger">basic_severity_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>severity</computeroutput> class template for a more detailed description </para></description><method-group name="public member functions">
  608. </method-group>
  609. <constructor><description><para>Default constructor </para></description></constructor>
  610. <constructor><parameter name="that"><paramtype><classname>wseverity_logger</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  611. <constructor specifiers="explicit"><template>
  612. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  613. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  614. <constructor specifiers="explicit"><parameter name="level"><paramtype>LevelT</paramtype><description><para>The default severity level </para></description></parameter><description><para>The constructor creates the logger with the specified default severity level</para><para>
  615. </para></description></constructor>
  616. <copy-assignment><type><classname>wseverity_logger</classname> &amp;</type><parameter name="that"><paramtype><classname>wseverity_logger</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  617. </class><class name="wseverity_logger_mt"><template>
  618. <template-type-parameter name="LevelT"><default>int</default></template-type-parameter>
  619. </template><inherit access="public">basic_composite_logger&lt; wchar_t, wseverity_logger_mt&lt; LevelT &gt;, multi_thread_model&lt; implementation_defined &gt;, features&lt; severity&lt; LevelT &gt; &gt; &gt;</inherit><purpose>Wide-char thread-safe logger. Functionally equivalent to <computeroutput><classname alt="boost::log::sources::basic_severity_logger">basic_severity_logger</classname></computeroutput>. </purpose><description><para>See <computeroutput>severity</computeroutput> class template for a more detailed description </para></description><method-group name="public member functions">
  620. </method-group>
  621. <constructor><description><para>Default constructor </para></description></constructor>
  622. <constructor><parameter name="that"><paramtype><classname>wseverity_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  623. <constructor specifiers="explicit"><template>
  624. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  625. </template><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter><description><para>Constructor with named arguments </para></description></constructor>
  626. <constructor specifiers="explicit"><parameter name="level"><paramtype>LevelT</paramtype><description><para>The default severity level </para></description></parameter><description><para>The constructor creates the logger with the specified default severity level</para><para>
  627. </para></description></constructor>
  628. <copy-assignment><type><classname>wseverity_logger_mt</classname> &amp;</type><parameter name="that"><paramtype><classname>wseverity_logger_mt</classname> const &amp;</paramtype></parameter><description><para>Assignment operator</para><para>Swaps two loggers </para></description></copy-assignment>
  629. </class>
  630. </namespace>
  631. </namespace>
  632. </namespace>
  633. </header>
  634. <header name="boost/log/sources/threading_models.hpp">
  635. <para><para>Andrey Semashev </para>
  636. <para>04.10.2008</para>
  637. The header contains definition of threading models that can be used in loggers. The header also provides a number of tags that can be used to express lock requirements on a function callee. </para><namespace name="boost">
  638. <namespace name="log">
  639. <namespace name="sources">
  640. <struct name="multi_thread_model"><template>
  641. <template-type-parameter name="MutexT"/>
  642. </template><purpose>Multi-thread locking model with maximum locking capabilities. </purpose><method-group name="public member functions">
  643. <method name="lock_shared" cv="const"><type>void</type></method>
  644. <method name="try_lock_shared" cv="const"><type>bool</type></method>
  645. <method name="timed_lock_shared" cv="const"><type>bool</type><template>
  646. <template-type-parameter name="TimeT"/>
  647. </template><parameter name="t"><paramtype>TimeT const &amp;</paramtype></parameter></method>
  648. <method name="unlock_shared" cv="const"><type>void</type></method>
  649. <method name="lock" cv="const"><type>void</type></method>
  650. <method name="try_lock" cv="const"><type>bool</type></method>
  651. <method name="timed_lock" cv="const"><type>bool</type><template>
  652. <template-type-parameter name="TimeT"/>
  653. </template><parameter name="t"><paramtype>TimeT const &amp;</paramtype></parameter></method>
  654. <method name="unlock" cv="const"><type>void</type></method>
  655. <method name="lock_upgrade" cv="const"><type>void</type></method>
  656. <method name="try_lock_upgrade" cv="const"><type>bool</type></method>
  657. <method name="timed_lock_upgrade" cv="const"><type>bool</type><template>
  658. <template-type-parameter name="TimeT"/>
  659. </template><parameter name="t"><paramtype>TimeT const &amp;</paramtype></parameter></method>
  660. <method name="unlock_upgrade" cv="const"><type>void</type></method>
  661. <method name="unlock_upgrade_and_lock" cv="const"><type>void</type></method>
  662. <method name="unlock_and_lock_upgrade" cv="const"><type>void</type></method>
  663. <method name="unlock_and_lock_shared" cv="const"><type>void</type></method>
  664. <method name="unlock_upgrade_and_lock_shared" cv="const"><type>void</type></method>
  665. <method name="swap"><type>void</type><parameter name=""><paramtype><classname>multi_thread_model</classname> &amp;</paramtype></parameter></method>
  666. </method-group>
  667. <constructor/>
  668. <constructor><parameter name=""><paramtype><classname>multi_thread_model</classname> const &amp;</paramtype></parameter></constructor>
  669. <copy-assignment><type><classname>multi_thread_model</classname> &amp;</type><parameter name=""><paramtype><classname>multi_thread_model</classname> const &amp;</paramtype></parameter></copy-assignment>
  670. </struct><struct name="single_thread_model"><purpose>Single thread locking model. </purpose><method-group name="public member functions">
  671. <method name="lock_shared" cv="const"><type>void</type></method>
  672. <method name="try_lock_shared" cv="const"><type>bool</type></method>
  673. <method name="timed_lock_shared" cv="const"><type>bool</type><template>
  674. <template-type-parameter name="TimeT"/>
  675. </template><parameter name=""><paramtype>TimeT const &amp;</paramtype></parameter></method>
  676. <method name="unlock_shared" cv="const"><type>void</type></method>
  677. <method name="lock" cv="const"><type>void</type></method>
  678. <method name="try_lock" cv="const"><type>bool</type></method>
  679. <method name="timed_lock" cv="const"><type>bool</type><template>
  680. <template-type-parameter name="TimeT"/>
  681. </template><parameter name=""><paramtype>TimeT const &amp;</paramtype></parameter></method>
  682. <method name="unlock" cv="const"><type>void</type></method>
  683. <method name="lock_upgrade" cv="const"><type>void</type></method>
  684. <method name="try_lock_upgrade" cv="const"><type>bool</type></method>
  685. <method name="timed_lock_upgrade" cv="const"><type>bool</type><template>
  686. <template-type-parameter name="TimeT"/>
  687. </template><parameter name=""><paramtype>TimeT const &amp;</paramtype></parameter></method>
  688. <method name="unlock_upgrade" cv="const"><type>void</type></method>
  689. <method name="unlock_upgrade_and_lock" cv="const"><type>void</type></method>
  690. <method name="unlock_and_lock_upgrade" cv="const"><type>void</type></method>
  691. <method name="unlock_and_lock_shared" cv="const"><type>void</type></method>
  692. <method name="unlock_upgrade_and_lock_shared" cv="const"><type>void</type></method>
  693. <method name="swap"><type>void</type><parameter name=""><paramtype><classname>single_thread_model</classname> &amp;</paramtype></parameter></method>
  694. </method-group>
  695. </struct>
  696. </namespace>
  697. </namespace>
  698. </namespace>
  699. </header>
  700. </library-reference>