top_level_reference.xml 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144
  1. <?xml version="1.0" standalone="yes"?>
  2. <library-reference id="top_level_headers"><title>Top level headers</title><header name="boost/log/attributes.hpp">
  3. <para><para>Andrey Semashev </para>
  4. <para>13.07.2009</para>
  5. This header includes other Boost.Log headers with all attributes. </para></header>
  6. <header name="boost/log/common.hpp">
  7. <para><para>Andrey Semashev </para>
  8. <para>14.03.2009</para>
  9. This header includes other Boost.Log headers that are commonly used in logging applications. Note that the header does not include any headers required to setup the library, as usually they aren't needed in more than one translation unit of the application. </para></header>
  10. <header name="boost/log/core.hpp">
  11. <para><para>Andrey Semashev </para>
  12. <para>19.04.2007</para>
  13. This header includes Boost.Log headers related to the logging core. </para></header>
  14. <header name="boost/log/exceptions.hpp">
  15. <para><para>Andrey Semashev </para>
  16. <para>31.10.2009</para>
  17. The header contains exception classes declarations. </para><namespace name="boost">
  18. <namespace name="log">
  19. <class name="bad_alloc"><inherit access="public">bad_alloc</inherit><purpose>Base class for memory allocation errors. </purpose><description><para>Exceptions derived from this class indicate problems with memory allocation. </para></description><method-group name="public member functions">
  20. <method name="what" cv="const"><type>const char *</type><description><para>Error message accessor. </para></description></method>
  21. </method-group>
  22. <constructor specifiers="explicit"><parameter name="descr"><paramtype>const char *</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  23. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  24. <destructor><description><para>Destructor </para></description></destructor>
  25. </class><class name="capacity_limit_reached"><inherit access="public">bad_alloc</inherit><purpose>The exception is used to indicate reaching a storage capacity limit. </purpose><method-group name="public member functions">
  26. </method-group>
  27. <constructor specifiers="explicit"><parameter name="descr"><paramtype>const char *</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  28. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  29. <destructor><description><para>Destructor </para></description></destructor>
  30. </class><class name="conversion_error"><inherit access="public">runtime_error</inherit><purpose>Exception class that is used to indicate conversion errors. </purpose><method-group name="public member functions">
  31. </method-group>
  32. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  33. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  34. <destructor><description><para>Destructor </para></description></destructor>
  35. </class><class name="invalid_type"><inherit access="public">runtime_error</inherit><purpose>Exception class that is used to indicate errors of incorrect type of an object. </purpose><method-group name="public member functions">
  36. </method-group>
  37. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  38. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  39. <destructor><description><para>Destructor </para></description></destructor>
  40. </class><class name="invalid_value"><inherit access="public">runtime_error</inherit><purpose>Exception class that is used to indicate errors of incorrect value of an object. </purpose><method-group name="public member functions">
  41. </method-group>
  42. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  43. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  44. <destructor><description><para>Destructor </para></description></destructor>
  45. </class><class name="limitation_error"><inherit access="public">logic_error</inherit><purpose>Exception class that is used to indicate library limitation. </purpose><method-group name="public member functions">
  46. </method-group>
  47. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  48. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  49. <destructor><description><para>Destructor </para></description></destructor>
  50. </class><class name="logic_error"><inherit access="public">logic_error</inherit><purpose>Base class for logic exceptions from the logging library. </purpose><description><para>Exceptions derived from this class usually indicate errors on the user's side, such as incorrect library usage. </para></description><method-group name="public member functions">
  51. </method-group>
  52. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  53. <destructor><description><para>Destructor </para></description></destructor>
  54. </class><class name="missing_value"><inherit access="public">runtime_error</inherit><purpose>Exception class that is used to indicate errors of missing values. </purpose><method-group name="public member functions">
  55. </method-group>
  56. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  57. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  58. <destructor><description><para>Destructor </para></description></destructor>
  59. </class><class name="odr_violation"><inherit access="public">logic_error</inherit><purpose>Exception class that is used to indicate ODR violation. </purpose><method-group name="public member functions">
  60. </method-group>
  61. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  62. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  63. <destructor><description><para>Destructor </para></description></destructor>
  64. </class><class name="parse_error"><inherit access="public">runtime_error</inherit><purpose>Exception class that is used to indicate parsing errors. </purpose><method-group name="public member functions">
  65. </method-group>
  66. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  67. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  68. <destructor><description><para>Destructor </para></description></destructor>
  69. </class><class name="runtime_error"><inherit access="public">runtime_error</inherit><purpose>Base class for runtime exceptions from the logging library. </purpose><description><para>Exceptions derived from this class indicate a problem that may not directly be caused by the user's code that interacts with the library, such as errors caused by input data. </para></description><method-group name="public member functions">
  70. </method-group>
  71. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  72. <destructor><description><para>Destructor </para></description></destructor>
  73. </class><class name="setup_error"><inherit access="public">logic_error</inherit><purpose>Exception class that is used to indicate invalid library setup. </purpose><method-group name="public member functions">
  74. </method-group>
  75. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  76. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  77. <destructor><description><para>Destructor </para></description></destructor>
  78. </class><class name="system_error"><inherit access="public">system_error</inherit><purpose>Exception class that is used to indicate underlying OS API errors. </purpose><method-group name="public member functions">
  79. </method-group>
  80. <constructor><parameter name="code"><paramtype>boost::system::error_code</paramtype></parameter><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  81. <destructor><description><para>Destructor </para></description></destructor>
  82. </class><class name="unexpected_call"><inherit access="public">logic_error</inherit><purpose>Exception class that is used to indicate invalid call sequence. </purpose><method-group name="public member functions">
  83. </method-group>
  84. <constructor><description><para>Default constructor. Creates an exception with the default error message. </para></description></constructor>
  85. <constructor specifiers="explicit"><parameter name="descr"><paramtype>std::string const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates an exception with the specified error message. </para></description></constructor>
  86. <destructor><description><para>Destructor </para></description></destructor>
  87. </class></namespace>
  88. </namespace>
  89. </header>
  90. <header name="boost/log/expressions.hpp">
  91. <para><para>Andrey Semashev </para>
  92. <para>10.11.2012</para>
  93. This header includes other Boost.Log headers with all template expression tools. </para></header>
  94. <header name="boost/log/sinks.hpp">
  95. <para><para>Andrey Semashev </para>
  96. <para>13.07.2009</para>
  97. This header includes other Boost.Log headers with all sinks. </para></header>
  98. <header name="boost/log/trivial.hpp">
  99. <para><para>Andrey Semashev </para>
  100. <para>07.11.2009</para>
  101. This header defines tools for trivial logging support </para><namespace name="boost">
  102. <namespace name="log">
  103. <namespace name="trivial">
  104. <struct name="logger"><purpose>Trivial logger tag. </purpose><description><para>This tag can be used to acquire the logger that is used with lrivial logging macros. This may be useful when the logger is used with other macros which require a logger. </para></description><typedef name="logger_type"><purpose>Logger type. </purpose><type>trivial::logger_type</type></typedef>
  105. <method-group name="public static functions">
  106. <method name="get" specifiers="static"><type>logger_type &amp;</type><description><para>Returns a reference to the trivial logger instance </para></description></method>
  107. </method-group>
  108. </struct><enum name="severity_level"><enumvalue name="trace"/><enumvalue name="debug"/><enumvalue name="info"/><enumvalue name="warning"/><enumvalue name="error"/><enumvalue name="fatal"/><purpose>Trivial severity levels. </purpose></enum>
  109. <typedef name="logger_type"><purpose>Trivial logger type. </purpose><type>sources::severity_logger_mt&lt; severity_level &gt;</type></typedef>
  110. <function name="to_string"><type>const CharT *</type><template>
  111. <template-type-parameter name="CharT"/>
  112. </template><parameter name="lvl"><paramtype>severity_level</paramtype></parameter><purpose>Returns stringized enumeration value or <computeroutput>NULL</computeroutput>, if the value is not valid. </purpose></function>
  113. <function name="from_string"><type>bool</type><template>
  114. <template-type-parameter name="CharT"/>
  115. </template><parameter name="str"><paramtype>const CharT *</paramtype></parameter><parameter name="len"><paramtype>std::size_t</paramtype></parameter><parameter name="lvl"><paramtype>severity_level &amp;</paramtype></parameter><purpose>Parses enumeration value from string and returns <computeroutput>true</computeroutput> on success and <computeroutput>false</computeroutput> otherwise. </purpose></function>
  116. <function name="operator&lt;&lt;"><type>std::basic_ostream&lt; CharT, TraitsT &gt; &amp;</type><template>
  117. <template-type-parameter name="CharT"/>
  118. <template-type-parameter name="TraitsT"/>
  119. </template><parameter name="strm"><paramtype>std::basic_ostream&lt; CharT, TraitsT &gt; &amp;</paramtype></parameter><parameter name="lvl"><paramtype>severity_level</paramtype></parameter><purpose>Outputs stringized representation of the severity level to the stream. </purpose></function>
  120. <function name="operator&gt;&gt;"><type>std::basic_istream&lt; CharT, TraitsT &gt; &amp;</type><template>
  121. <template-type-parameter name="CharT"/>
  122. <template-type-parameter name="TraitsT"/>
  123. </template><parameter name="strm"><paramtype>std::basic_istream&lt; CharT, TraitsT &gt; &amp;</paramtype></parameter><parameter name="lvl"><paramtype>severity_level &amp;</paramtype></parameter><purpose>Reads stringized representation of the severity level from the stream. </purpose></function>
  124. </namespace>
  125. </namespace>
  126. </namespace>
  127. <macro name="BOOST_LOG_TRIVIAL" kind="functionlike"><macro-parameter name="lvl"/><description><para>The macro is used to initiate logging. The <computeroutput>lvl</computeroutput> argument of the macro specifies one of the following severity levels: <computeroutput>trace</computeroutput>, <computeroutput>debug</computeroutput>, <computeroutput>info</computeroutput>, <computeroutput>warning</computeroutput>, <computeroutput>error</computeroutput> or <computeroutput>fatal</computeroutput> (see <computeroutput>severity_level</computeroutput> enum). Following the macro, there may be a streaming expression that composes the record message string. For example:</para><para><programlisting language="c++">BOOST_LOG_TRIVIAL(info) &lt;&lt; "Hello, world!";
  128. </programlisting> </para></description></macro>
  129. </header>
  130. </library-reference>