diff --git a/doc/configuration_macros.html b/doc/configuration_macros.html index f38828b..3182853 100644 --- a/doc/configuration_macros.html +++ b/doc/configuration_macros.html @@ -25,6 +25,8 @@

BOOST_NO_RTTI 
BOOST_NO_TYPEID

The first macro prevents Boost Exception from using dynamic_cast and dynamic typeid. If the second macro is also defined, Boost Exception does not use static typeid either. There are no observable degrading effects on the library functionality, except for the following:

By default, the get_error_info function template can be called with any exception type. If BOOST_NO_RTTI is defined, get_error_info can be used only with objects of type boost::exception.

+

Note:

+

The library needs RTTI functionality. Disabling the language RTTI support enables an internal RTTI system, which may have more or less overhead depending on the platform.

BOOST_EXCEPTION_DISABLE

By default, enable_current_exception and enable_error_info are integrated directly in the throw_exception function. Defining BOOST_EXCEPTION_DISABLE disables this integration.

Note that on some non-conformant compilers, for example MSVC 7.0 and older, as well as BCC, BOOST_EXCEPTION_DISABLE is implicitly defined in boost/throw_exception.hpp.

diff --git a/doc/source/boost-exception.reno b/doc/source/boost-exception.reno index ed8b813..f61dc8a 100644 --- a/doc/source/boost-exception.reno +++ b/doc/source/boost-exception.reno @@ -2247,19 +2247,6 @@ (:include include:) (:auto also:) - - - 0 - - -34 - - - - 1 - 2 - (:include include:) (:auto also:) - - 0 @@ -2273,19 +2260,6 @@ (:include include:) (:auto also:) - - - 0 - - -36 - - - - 1 - 2 - (:include include:) (:auto also:) - - 0 @@ -2325,19 +2299,6 @@ (:include include:) (:auto also:) - - - 0 - - -39 - - - - 1 - 2 - (:include include:) (:auto also:) - - 0 @@ -2351,19 +2312,6 @@ (:include include:) (:auto also:) - - - 0 - - -35 - - - - 1 - 2 - (:include include:) (:auto also:) - - 0 @@ -2381,7 +2329,7 @@ 0 - -38 + -34 @@ -2394,43 +2342,26 @@ 0 - 46 - - reno_context - - - - - - - 1 - 187BFD2B78A0DD006717B5B06FFD465E2468F521C32A86FB793F7A68AB5417F3 - 4276724153 - 574 - 382 - - - - - - 0 - ../../example/error_info_1.cpp - 0 - 0 - - - - - <string>adding of arbitrary data at the point of the throw</string> - - - adding_data_at_throw - - + -35 - 0 + 1 + 2 + (:include include:) (:auto also:) + + + + + 0 + + -36 + + + + 1 + 2 + (:include include:) (:auto also:) @@ -2450,47 +2381,20 @@ 0 - 47 - - reno_context - - - - - - - 3 - 126BB1D8971585CBE7D78EF3C12259D72FD5E973A84626AA9FC3234220A11CAB - 3471702891 - 969 - 344 - A7FD310E1340E103081DA2A7899DA0E213C696C84D52C17ADA09F6942EE97D47 - 2978648279 - 530 - 433 - 38B566F2C6678B8724D18086A6F76E077DC2ADC1BB69A4B83BF0A2C3B7D31B50 - 2218658069 - 31 - 143 - - - - - - 0 - ../../../../boost/exception/detail/error_info_impl.hpp - 0 - 0 - - - - - <string>error_info::value_type</string> - - - - - + -38 + + + + 1 + 2 + (:include include:) (:auto also:) + + + + + 0 + + -39 @@ -2577,6 +2481,102 @@ (:auto !:) (:pagelist fmt="index" except_tags="index noindex" mod="w":) + + + 0 + + 46 + + reno_context + + + + + + + 1 + 187BFD2B78A0DD006717B5B06FFD465E2468F521C32A86FB793F7A68AB5417F3 + 4276724153 + 574 + 382 + + + + + + 0 + ../../example/error_info_1.cpp + 0 + 0 + + + + + <string>adding of arbitrary data at the point of the throw</string> + + + adding_data_at_throw + + + + + + 0 + + + + + 0 + + 47 + + reno_context + + + + + + + 3 + 126BB1D8971585CBE7D78EF3C12259D72FD5E973A84626AA9FC3234220A11CAB + 3471702891 + 969 + 344 + A7FD310E1340E103081DA2A7899DA0E213C696C84D52C17ADA09F6942EE97D47 + 2978648279 + 530 + 433 + 38B566F2C6678B8724D18086A6F76E077DC2ADC1BB69A4B83BF0A2C3B7D31B50 + 2218658069 + 31 + 143 + + + + + + 0 + ../../../../boost/exception/detail/error_info_impl.hpp + 0 + 0 + + + + + <string>error_info::value_type</string> + + + + + + + + + 1 + 2 + (:include include:) (:auto also:) + + 0 @@ -3079,17 +3079,6 @@ 0 - - - 0 - - -34 - - - - 0 - - 0 @@ -3101,17 +3090,6 @@ 0 - - - 0 - - -36 - - - - 0 - - 0 @@ -3212,17 +3190,6 @@ decl pre_indent="4":) };@] - - - 0 - - -39 - - - - 0 - - 0 @@ -3234,17 +3201,6 @@ 0 - - - 0 - - -35 - - - - 0 - - 0 @@ -3260,7 +3216,7 @@ 0 - -38 + -34 @@ -3271,7 +3227,18 @@ 0 - -46 + -35 + + + + 0 + + + + + 0 + + -36 @@ -3293,7 +3260,18 @@ 0 - -47 + -38 + + + + 0 + + + + + 0 + + -39 @@ -3366,6 +3344,28 @@ 0 + + + 0 + + -46 + + + + 0 + + + + + 0 + + -47 + + + + 0 + + 0 @@ -3757,17 +3757,6 @@ 0 - - - 0 - - -34 - - - - 0 - - 0 @@ -3779,17 +3768,6 @@ 0 - - - 0 - - -36 - - - - 0 - - 0 @@ -3823,28 +3801,6 @@ 0 - - - 0 - - -39 - - - - 3 - 2 - [@(:include - 1 - - 0 - - -6 - - - 2 - decl:)@] - - 0 @@ -3856,17 +3812,6 @@ 0 - - - 0 - - -35 - - - - 0 - - 0 @@ -3882,29 +3827,29 @@ 0 - -38 + -34 - 3 - 2 - [@(:include - 1 - - 0 - - -35 - - - 2 - decl:)@] + 0 0 - -46 + -35 + + + + 0 + + + + + 0 + + -36 @@ -3991,11 +3936,44 @@ 0 - -47 + -38 - 0 + 3 + 2 + [@(:include + 1 + + 0 + + -35 + + + 2 + decl:)@] + + + + + 0 + + -39 + + + + 3 + 2 + [@(:include + 1 + + 0 + + -6 + + + 2 + decl:)@] @@ -4173,6 +4151,28 @@ 0 + + + 0 + + -46 + + + + 0 + + + + + 0 + + -47 + + + + 0 + + 0 @@ -4751,37 +4751,6 @@ :)( E const & e ); #endif@] - - - 0 - - -34 - - - - 5 - 2 - [@class (:link - 1 - - 0 - - -34 - - - 2 - :): public std::exception public boost:: - 1 - - 0 - - -30 - - - 2 - { ---unspecified--- };@] - - 0 @@ -4793,17 +4762,6 @@ 0 - - - 0 - - -36 - - - - 0 - - 0 @@ -4859,17 +4817,6 @@ :);@] - - - 0 - - -39 - - - - 0 - - 0 @@ -4892,37 +4839,6 @@ :);@] - - - 0 - - -35 - - - - 5 - 2 - [@std::string (:link - 1 - - 0 - - -35 - - - 2 - :)( boost::(:link - 1 - - 0 - - -30 - - - 2 - :) const & );@] - - 0 @@ -4958,18 +4874,69 @@ 0 - -38 + -34 - 0 + 5 + 2 + [@class (:link + 1 + + 0 + + -34 + + + 2 + :): public std::exception public boost:: + 1 + + 0 + + -30 + + + 2 + { ---unspecified--- };@] 0 - -46 + -35 + + + + 5 + 2 + [@std::string (:link + 1 + + 0 + + -35 + + + 2 + :)( boost::(:link + 1 + + 0 + + -30 + + + 2 + :) const & );@] + + + + + 0 + + -36 @@ -4991,22 +4958,22 @@ 0 - -47 + -38 - 3 - 2 - [@typedef T (:link - 1 - - 0 - - -47 - - - 2 - mod="m":);@] + 0 + + + + + 0 + + -39 + + + + 0 @@ -5075,6 +5042,39 @@ 0 + + + 0 + + -46 + + + + 0 + + + + + 0 + + -47 + + + + 3 + 2 + [@typedef T (:link + 1 + + 0 + + -47 + + + 2 + mod="m":);@] + + 0 @@ -6813,37 +6813,6 @@ :) returns, the behavior is undefined. - - - 0 - - -34 - - - - 5 - 2 - (:auto !!!:) (:include synopsis:) This type is used by the (:link - 1 - - 0 - - -32 - - - 2 - :) support in Boost Exception. Please see (:link - 1 - - 0 - - -8 - - - 2 - :). - - 0 @@ -6938,82 +6907,6 @@ :) - - - 0 - - -36 - - - - 15 - 2 - (:auto !!!:) Boost Exception responds to the following configuration macros: '''BOOST_NO_RTTI'''\\ '''BOOST_NO_TYPEID''' The first macro prevents Boost Exception from using dynamic_cast and dynamic typeid. If the second macro is also defined, Boost Exception does not use static typeid either. There are no observable degrading effects on the library functionality, except for the following: ->By default, the (:link - 1 - - 0 - - -12 - - - 2 - :) function template can be called with any exception type. If BOOST_NO_RTTI is defined, (:link - 1 - - 0 - - -12 - - - 2 - :) can be used only with objects of type boost::(:link - 1 - - 0 - - -30 - - - 2 - :). '''BOOST_EXCEPTION_DISABLE''' By default, (:link - 1 - - 0 - - -20 - - - 2 - :) and (:link - 1 - - 0 - - -6 - - - 2 - :) are integrated directly in the (:link - 1 - - 0 - - -27 - - - 2 - :) function. Defining BOOST_EXCEPTION_DISABLE disables this integration. Note that on some non-conformant compilers, for example MSVC 7.0 and older, as well as BCC, BOOST_EXCEPTION_DISABLE is implicitly defined in (:link - 1 - - 0 - - -44 - - - 2 - :). - - 0 @@ -7287,19 +7180,6 @@ <errno_info>(x) ) .... }@] - - - 0 - - -39 - - - - 1 - 2 - (:auto !!!:) !!!Synopsis (:include synopsis:) - - 0 @@ -7385,6 +7265,50 @@ :) concurrently to throw the same exception object into multiple threads. + + + 0 + + -33 + + + + 1 + 2 + (:auto !!!:) (:include synopsis:) !!!!Precondition: ep shall not be null. !!!!Throws: The exception to which ep refers. + + + + + 0 + + -34 + + + + 5 + 2 + (:auto !!!:) (:include synopsis:) This type is used by the (:link + 1 + + 0 + + -32 + + + 2 + :) support in Boost Exception. Please see (:link + 1 + + 0 + + -8 + + + 2 + :). + + 0 @@ -7501,13 +7425,89 @@ 0 - -33 + -36 + + + + 15 + 2 + (:auto !!!:) Boost Exception responds to the following configuration macros: '''BOOST_NO_RTTI'''\\ '''BOOST_NO_TYPEID''' The first macro prevents Boost Exception from using dynamic_cast and dynamic typeid. If the second macro is also defined, Boost Exception does not use static typeid either. There are no observable degrading effects on the library functionality, except for the following: ->By default, the (:link + 1 + + 0 + + -12 + + + 2 + :) function template can be called with any exception type. If BOOST_NO_RTTI is defined, (:link + 1 + + 0 + + -12 + + + 2 + :) can be used only with objects of type boost::(:link + 1 + + 0 + + -30 + + + 2 + :). !!!!Note: The library needs RTTI functionality. Disabling the language RTTI support enables an internal RTTI system, which may have more or less overhead depending on the platform. '''BOOST_EXCEPTION_DISABLE''' By default, (:link + 1 + + 0 + + -20 + + + 2 + :) and (:link + 1 + + 0 + + -6 + + + 2 + :) are integrated directly in the (:link + 1 + + 0 + + -27 + + + 2 + :) function. Defining BOOST_EXCEPTION_DISABLE disables this integration. Note that on some non-conformant compilers, for example MSVC 7.0 and older, as well as BCC, BOOST_EXCEPTION_DISABLE is implicitly defined in (:link + 1 + + 0 + + -44 + + + 2 + :). + + + + + 0 + + -37 1 2 - (:auto !!!:) (:include synopsis:) !!!!Precondition: ep shall not be null. !!!!Throws: The exception to which ep refers. + (:auto !!:) !!!Synopsis (:include synopsis:) @@ -7523,6 +7523,95 @@ (:auto !!:) !!!Synopsis (:include synopsis:) + + + 0 + + -39 + + + + 1 + 2 + (:auto !!!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -40 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -41 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -42 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -43 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -44 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -45 + + + + 0 + + 0 @@ -7608,19 +7697,6 @@ :) function template is instantiated with the typedef from (1), and is passed an exception object of a polymorphic type. If the exception object contains the requested value, the returned (:link http://www.boost.org/libs/smart_ptr/shared_ptr.htm|shared_ptr:) will point to it; otherwise an empty (:link http://www.boost.org/libs/smart_ptr/shared_ptr.htm|shared_ptr:) is returned. - - - 0 - - -37 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - 0 @@ -7652,82 +7728,6 @@ mod="m":) evaluates to T. - - - 0 - - -40 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -41 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -42 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -43 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -44 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -45 - - - - 0 - - 0 @@ -8219,17 +8219,6 @@ 0 - - - 0 - - -34 - - - - 0 - - 0 @@ -8241,17 +8230,6 @@ 0 - - - 0 - - -36 - - - - 0 - - 0 @@ -8285,17 +8263,6 @@ 0 - - - 0 - - -39 - - - - 0 - - 0 @@ -8307,17 +8274,6 @@ 0 - - - 0 - - -35 - - - - 0 - - 0 @@ -8333,7 +8289,7 @@ 0 - -38 + -34 @@ -8344,7 +8300,18 @@ 0 - -46 + -35 + + + + 0 + + + + + 0 + + -36 @@ -8366,7 +8333,18 @@ 0 - -47 + -38 + + + + 0 + + + + + 0 + + -39 @@ -8439,6 +8417,28 @@ 0 + + + 0 + + -46 + + + + 0 + + + + + 0 + + -47 + + + + 0 + + 0 @@ -8895,28 +8895,6 @@ :)> [@namespace boost { (:include decl:) }@] - - - 0 - - -34 - - - - 3 - 2 - `#include <(:link - 1 - - 0 - - -43 - - - 2 - :)> [@namespace boost { (:include decl pre_indent="4":) }@] - - 0 @@ -8928,17 +8906,6 @@ 0 - - - 0 - - -36 - - - - 0 - - 0 @@ -8998,29 +8965,51 @@ 0 - -39 + -32 3 2 - [@#include < + `#include <(:link 1 0 - -22 + -43 2 - > namespace boost { (:include api pre_indent="4":) }@] + :)> [@namespace boost { (:include decl pre_indent="4":) }@] 0 - -32 + -33 + + + + 3 + 2 + `#include <(:link + 1 + + 0 + + -43 + + + 2 + :)> [@namespace boost { (:include decl pre_indent="4":) }@] + + + + + 0 + + -34 @@ -9064,22 +9053,24 @@ 0 - -33 + -36 - 3 + 0 + + + + + 0 + + -37 + + + + 1 2 - `#include <(:link - 1 - - 0 - - -43 - - - 2 - :)> [@namespace boost { (:include decl pre_indent="4":) }@] + [@(:include api:)@] @@ -9108,46 +9099,22 @@ 0 - -46 - - - - 0 - - - - - 0 - - -37 - - - - 1 - 2 - [@(:include api:)@] - - - - - 0 - - -47 + -39 3 2 - `#include <(:link + [@#include < 1 0 - -41 + -22 2 - :)> [@(:include decl:)@] + > namespace boost { (:include api pre_indent="4":) }@] @@ -9244,6 +9211,39 @@ 0 + + + 0 + + -46 + + + + 0 + + + + + 0 + + -47 + + + + 3 + 2 + `#include <(:link + 1 + + 0 + + -41 + + + 2 + :)> [@(:include decl:)@] + + 0 @@ -9397,15 +9397,9 @@ -27 - - -34 - -28 - - -36 - -29 @@ -9415,29 +9409,29 @@ -31 - - -39 - -32 - - -35 - -33 - -38 + -34 - -46 + -35 + + + -36 -37 - -47 + -38 + + + -39 -40 @@ -9457,6 +9451,12 @@ -45 + + -46 + + + -47 + -48 @@ -10860,15 +10860,6 @@ free function - - - 0 - - -34 - - - exception_ptr type - 0 @@ -10905,15 +10896,6 @@ type - - - 0 - - -39 - - - error_info - 0 @@ -10923,15 +10905,6 @@ type - - - 0 - - -35 - - - diagnostic_information free function - 0 @@ -10945,19 +10918,19 @@ 0 - -38 + -34 - + exception_ptr type 0 - -46 + -35 - noalso noindex tutorial + diagnostic_information free function @@ -10972,10 +10945,19 @@ 0 - -47 + -38 - type + + + + + 0 + + -39 + + + error_info @@ -11031,6 +11013,24 @@ + + + 0 + + -46 + + + noalso noindex tutorial + + + + 0 + + -47 + + + type + 0