diff --git a/doc/BOOST_THROW_EXCEPTION.html b/doc/BOOST_THROW_EXCEPTION.html index bf355d7..255b8e2 100644 --- a/doc/BOOST_THROW_EXCEPTION.html +++ b/doc/BOOST_THROW_EXCEPTION.html @@ -25,13 +25,13 @@ 
#if !defined( BOOST_EXCEPTION_DISABLE )
     #include <boost/exception/exception.hpp>
     #include <boost/current_function.hpp>
-    #define BOOST_THROW_EXCEPTION(x)\
+    #define BOOST_THROW_EXCEPTION(x)\
         ::boost::throw_exception( ::boost::enable_error_info(x) <<\
         ::boost::throw_function(BOOST_CURRENT_FUNCTION) <<\
         ::boost::throw_file(__FILE__) <<\
         ::boost::throw_line((int)__LINE__) )
 #else
-    #define BOOST_THROW_EXCEPTION(x) ::boost::throw_exception(x)
+    #define BOOST_THROW_EXCEPTION(x) ::boost::throw_exception(x)
 #endif

This macro takes an exception object, records BOOST_CURRENT_FUNCTION, __FILE__ and __LINE__ in it, and forwards it to throw_exception. To recover this information at the catch site, use get_error_info; the information is also included in the message returned by diagnostic_information.

diff --git a/doc/copy_exception.html b/doc/copy_exception.html index aa53f1d..58cdfca 100644 --- a/doc/copy_exception.html +++ b/doc/copy_exception.html @@ -26,7 +26,7 @@ boost { template <class T> - exception_ptr copy_exception( T const & e ); + exception_ptr copy_exception( T const & e ); }

Effects:

As if

diff --git a/doc/current_exception.html b/doc/current_exception.html index fafa93b..9ad515a 100644 --- a/doc/current_exception.html +++ b/doc/current_exception.html @@ -25,10 +25,10 @@ 
namespace
 boost
     {
-    exception_ptr current_exception();
+    exception_ptr current_exception();
     }

Requirements:

-

The current_exception function must not be called outside of a catch block.

+

The current_exception function must not be called outside of a catch block.

Returns:

Requirements:

This function must not be called outside of a catch block.

Returns:

If the current exception object can be converted to boost::exception or std::exception, this function returns the same string value returned by diagnostic_information for the current exception object. Otherwise, an unspecified non-empty string is returned.

-

Typical use is to call current_exception_diagnostic_information from a top-level function to output diagnostic information about unhandled exceptions:

+

Typical use is to call current_exception_diagnostic_information from a top-level function to output diagnostic information about unhandled exceptions:

int
 main()
     {
@@ -48,7 +48,7 @@ main()
     ...)
         {
         std::cerr << "Unhandled exception!" << std::endl <<
-            boost::current_exception_diagnostic_information();
+            boost::current_exception_diagnostic_information();
         }
     }
diff --git a/doc/diagnostic_information.html b/doc/diagnostic_information.html index fba631b..8df5968 100644 --- a/doc/diagnostic_information.html +++ b/doc/diagnostic_information.html @@ -26,7 +26,7 @@ boost { template <class E> - std::string diagnostic_information( E const & e ); + std::string diagnostic_information( E const & e ); }

Returns:

A string value that contains varying amount of implementation-specific diagnostic information about the passed exception object:

@@ -35,21 +35,21 @@ boost
  • otherwise the returned value contains the what() string.
    • -
  • Otherwise, the boost::diagnostic_information template is not available.
    • +
  • Otherwise, the boost::diagnostic_information template is not available.

    • The string representation of each error_info object is deduced by a function call that is bound at the time the error_info<Tag,T> template is instantiated. The following overload resolutions are attempted in order:

    1. Unqualified call to to_string(x), where x is of type error_info<Tag,T> (the return value is expected to be of type std::string.)
    2. Unqualified call to to_string(x.value()) (the return value is expected to be of type std::string.)
    3. Unqualified call to s << x.value(), where s is a std::ostringstream.
    -

    The first successfully bound function is used at the time diagnostic_information is called; if all 3 overload resolutions are unsuccessful, the system is unable to convert the error_info object to string, and an unspecified stub string value is used without issuing a compile error.

    +

    The first successfully bound function is used at the time diagnostic_information is called; if all 3 overload resolutions are unsuccessful, the system is unable to convert the error_info object to string, and an unspecified stub string value is used without issuing a compile error.

    Notes:

    Example:

    -

    this is a possible output from the diagnostic_information function, as used in libs/exception/example/example_io.cpp:

    +

    this is a possible output from the diagnostic_information function, as used in libs/exception/example/example_io.cpp:

    example_io.cpp(83): Throw in function class boost::shared_ptr<struct _iobuf> __cdecl my_fopen(const char *,const char *)
 Dynamic exception type: class boost::exception_detail::clone_impl<class fopen_error>
 std::exception::what: example_io error
diff --git a/doc/enable_current_exception.html b/doc/enable_current_exception.html
index 959a1ab..60491e8 100644
--- a/doc/enable_current_exception.html
+++ b/doc/enable_current_exception.html
@@ -26,7 +26,7 @@
 boost
     {
     template <class T>
-    ---unspecified--- enable_current_exception( T const & e );
+    ---unspecified--- enable_current_exception( T const & e );
     }

    Requirements:

    T must be a class with an accessible no-throw copy constructor.

    @@ -41,8 +41,8 @@ my_exception: }; .... -throw boost::enable_current_exception(my_exception()); -

    Unless enable_current_exception is called at the time an exception object is used in a throw-expression, an attempt to copy it using current_exception may return an exception_ptr which refers to an instance of unknown_exception. See current_exception for details.

    +throw boost::enable_current_exception(my_exception()); +

    Unless enable_current_exception is called at the time an exception object is used in a throw-expression, an attempt to copy it using current_exception may return an exception_ptr which refers to an instance of unknown_exception. See current_exception for details.

    Note:

    Instead of using the throw keyword directly, it is preferable to call boost::throw_exception. This is guaranteed to throw an exception that derives from boost::exception and supports the exception_ptr functionality.

    diff --git a/doc/enable_error_info.html b/doc/enable_error_info.html index 994e00e..b1ba069 100644 --- a/doc/enable_error_info.html +++ b/doc/enable_error_info.html @@ -26,7 +26,7 @@ boost { template <class T> - ---unspecified--- enable_error_info( T const & x ); + ---unspecified--- enable_error_info( T const & x ); }

    Requirements:

    T must be a class with an accessible no-throw copy constructor as per (15.5.1).

    diff --git a/doc/error_info.html b/doc/error_info.html index e26c82d..b14482a 100644 --- a/doc/error_info.html +++ b/doc/error_info.html @@ -27,7 +27,7 @@ boost { template <class Tag,class T> class - error_info + error_info { public: @@ -40,17 +40,17 @@ boost

    Requirements:

    T must have accessible copy constructor and must not be a reference (there is no requirement that T's copy constructor does not throw.)

    Description:

    -

    This class template is used to associate a Tag type with a value type T. Objects of type error_info<Tag,T> can be passed to operator<< to be stored in objects of type boost::exception.

    +

    This class template is used to associate a Tag type with a value type T. Objects of type error_info<Tag,T> can be passed to operator<< to be stored in objects of type boost::exception.

    Usage:

    -

    The header <boost/exception/error_info.hpp> provides a declaration of the error_info template, which is sufficient for the purpose of typedefing an instance for specific Tag and T, for example:

    +

    The header <boost/exception/error_info.hpp> provides a declaration of the error_info template, which is sufficient for the purpose of typedefing an instance for specific Tag and T, for example:

    #include <boost/exception/error_info.hpp>
 
 struct tag_errno;
-typedef boost::error_info<tag_errno,int> errno_info;
    +typedef boost::error_info<tag_errno,int> errno_info;

    Or, the shorter equivalent:

    #include <boost/exception/error_info.hpp>
 
-typedef boost::error_info<struct tag_errno,int> errno_info;
    +typedef boost::error_info<struct tag_errno,int> errno_info;

    This errno_info typedef can be passed to operator<< (#include <boost/exception/info.hpp> first) to store an int named tag_errno in exceptions of types that derive from boost::exception:

    throw file_read_error() << errno_info(errno);

    It can also be passed to get_error_info (#include <boost/exception/get_error_info.hpp> first) to retrieve the tag_errno int from a boost::exception:

    diff --git a/doc/error_info_error_info.html b/doc/error_info_error_info.html index 3b2dab0..1585d20 100644 --- a/doc/error_info_error_info.html +++ b/doc/error_info_error_info.html @@ -22,7 +22,7 @@

    error_info::error_info

    #include <boost/exception/info.hpp>

    -
    error_info( value_type const & v );
    +
    error_info( value_type const & v );

    Effects:

    Stores a copy of v in the error_info object.

    Throws:

    diff --git a/doc/error_info_value.html b/doc/error_info_value.html index 3ec9b2b..19422e1 100644 --- a/doc/error_info_value.html +++ b/doc/error_info_value.html @@ -22,7 +22,7 @@

    error_info::value

    #include <boost/exception/info.hpp>

    -
    value_type const & value() const;
    +
    value_type const & value() const;

    Description:

    Returns a const reference to the copy of the value passed to error_info's constructor stored in the error_info object.

    Throws:

    diff --git a/doc/error_info_value_type.html b/doc/error_info_value_type.html index b3c47f9..29d3677 100644 --- a/doc/error_info_value_type.html +++ b/doc/error_info_value_type.html @@ -22,14 +22,15 @@

    error_info::value_type

    #include <boost/exception/info.hpp>

    -
    typedef T value_type;
    +
    typedef T value_type;

    Definition:

    -

    The expression error_info<Tag,T>::value_type evaluates to T.

    +

    The expression error_info<Tag,T>::value_type evaluates to T.

    See Also:

    error_info
    error_info::error_info
    error_info::value
    +    get_error_info
    diff --git a/doc/exception.html b/doc/exception.html index b4ed803..a1f2b3e 100644 --- a/doc/exception.html +++ b/doc/exception.html @@ -26,18 +26,18 @@ boost { class - exception + exception { protected: exception(); - exception( exception const & x ); + exception( exception const & x ); ~exception(); }; } -

    Class boost::exception is designed to be used as a universal base for user-defined exception types.

    -

    An object of any type deriving from boost::exception can store data of arbitrary types, using the error_info wrapper and operator<<.

    -

    To retrieve data from a boost::exception object, use the get_error_info function template.

    +

    Class boost::exception is designed to be used as a universal base for user-defined exception types.

    +

    An object of any type deriving from boost::exception can store data of arbitrary types, using the error_info wrapper and operator<<.

    +

    To retrieve data from a boost::exception object, use the get_error_info function template.

    See Also:

    Boost Exception
    diff --git a/doc/exception_constructors.html b/doc/exception_constructors.html index 6410564..b14e30f 100644 --- a/doc/exception_constructors.html +++ b/doc/exception_constructors.html @@ -21,8 +21,8 @@

    exception::exception

    -
    exception();
-exception( exception const & x );
    +
    exception();
+exception( exception const & x );

    Effects:

    • Default constructor: initializes an empty boost::exception object.
    • Copy constructor: initializes a boost::exception object which shares ownership with x of all data added through operator<<, including data that is added at a future time.
      • diff --git a/doc/exception_destructor.html b/doc/exception_destructor.html index 9b8d36b..897d9dc 100644 --- a/doc/exception_destructor.html +++ b/doc/exception_destructor.html @@ -21,7 +21,7 @@

      exception::~exception

      -
      ~exception();
      +
      ~exception();

      Effects:

      Frees all resources associated with a boost::exception object.

      Throws:

      diff --git a/doc/exception_get_error_info_hpp.html b/doc/exception_get_error_info_hpp.html index 727c7c5..744a6ab 100644 --- a/doc/exception_get_error_info_hpp.html +++ b/doc/exception_get_error_info_hpp.html @@ -28,7 +28,7 @@ namespace boost { template <class ErrorInfo,class E> - typename ErrorInfo::value_type const * get_error_info( E const & x ); + typename ErrorInfo::value_type const * get_error_info( E const & x ); }

      See Also:

      diff --git a/doc/exception_operator_shl.html b/doc/exception_operator_shl.html index f7fd0a1..2e30ec2 100644 --- a/doc/exception_operator_shl.html +++ b/doc/exception_operator_shl.html @@ -26,7 +26,7 @@ boost { template <class E, class Tag, class T> - E const & operator<<( E const & x, error_info<Tag,T> const & v ); + E const & operator<<( E const & x, error_info<Tag,T> const & v ); }

      Requirements:

      E must be boost::exception, or a type that derives (indirectly) from boost::exception.

      diff --git a/doc/exception_ptr.html b/doc/exception_ptr.html index c7de1f6..f7fafcf 100644 --- a/doc/exception_ptr.html +++ b/doc/exception_ptr.html @@ -25,14 +25,14 @@ 
      namespace
 boost
     {
-    typedef ---unspecified--- exception_ptr;
+    typedef ---unspecified--- exception_ptr;
     }
      -

    The exception_ptr type can be used to refer to a copy of an exception object. It is Default Constructible, Copy Constructible, Assignable and Equality Comparable; exception_ptr's operations do not throw.

    -

    Two instances of exception_ptr are equivalent and compare equal if and only if they refer to the same exception.

    -

    The default constructor of exception_ptr produces the null value of the type. The null value is equivalent only to itself.

    +

    The exception_ptr type can be used to refer to a copy of an exception object. It is Default Constructible, Copy Constructible, Assignable and Equality Comparable; exception_ptr's operations do not throw.

    +

    Two instances of exception_ptr are equivalent and compare equal if and only if they refer to the same exception.

    +

    The default constructor of exception_ptr produces the null value of the type. The null value is equivalent only to itself.

    Thread safety

    -
    • It is legal for multiple threads to hold exception_ptr references to the same exception object.
      • -
    • It is illegal for multiple threads to modify the same exception_ptr object concurrently.
      • +
      • It is legal for multiple threads to hold exception_ptr references to the same exception object.
        • +
      • It is illegal for multiple threads to modify the same exception_ptr object concurrently.
      • While calling current_exception makes a copy of the current exception object, it is still possible for the two copies to share internal state. Therefore, in general it is not safe to call rethrow_exception concurrently to throw the same exception object into multiple threads.
    diff --git a/doc/get_error_info.html b/doc/get_error_info.html index e7cdeef..8033e82 100644 --- a/doc/get_error_info.html +++ b/doc/get_error_info.html @@ -25,7 +25,7 @@ boost { template <class ErrorInfo,class E> - typename ErrorInfo::value_type const * get_error_info( E const & x ); + typename ErrorInfo::value_type const * get_error_info( E const & x ); }

    Requirements:

    • ErrorInfo must be an instance of the error_info template.
      • @@ -33,12 +33,12 @@ boost

    Returns:

    • If dynamic_cast<boost::exception const *>(&x) is 0, or if x does not store an object of type ErrorInfo, the returned value is null.
      • -
    • Otherwise, the returned pointer points to the stored value (use operator<< to store values in exception objects.) When x is destroyed, any pointers returned by get_error_info become invalid.
      • +
    • Otherwise, the returned pointer points to the stored value (use operator<< to store values in exception objects.) When x is destroyed, any pointers returned by get_error_info become invalid.

    Throws:

    Nothing.

    Note:

    -

    The interface of get_error_info may be affected by the build configuration macros.

    +

    The interface of get_error_info may be affected by the build configuration macros.

    See Also:

    BOOST_THROW_EXCEPTION
    diff --git a/doc/rethrow_exception.html b/doc/rethrow_exception.html index 8c23c43..6bdef28 100644 --- a/doc/rethrow_exception.html +++ b/doc/rethrow_exception.html @@ -25,7 +25,7 @@ 
    namespace
 boost
     {
-    void rethrow_exception( exception_ptr const & ep );
+    void rethrow_exception( exception_ptr const & ep );
     }

    Precondition:

    ep shall not be null.

    diff --git a/doc/source/boost-exception.reno b/doc/source/boost-exception.reno index 6cd9ce9..2e58002 100644 --- a/doc/source/boost-exception.reno +++ b/doc/source/boost-exception.reno @@ -48,6 +48,44 @@ reno_context + + + + + + 0 + + + + + + 1 + + + + + <string>transporting of arbitrary data to the catch site</string> + + + tutorial_transporting_data + + + + + + 1 + 2 + (:include include:) (:auto also:) + + + + + 0 + + 6 + + reno_context + @@ -93,7 +131,7 @@ 0 - 6 + 7 reno_context @@ -142,7 +180,7 @@ 0 - 7 + 8 reno_context @@ -191,7 +229,7 @@ 0 - 8 + 9 reno_context @@ -240,7 +278,7 @@ 0 - 9 + 10 reno_context @@ -278,7 +316,7 @@ 0 - 10 + 11 reno_context @@ -316,7 +354,7 @@ 0 - 11 + 12 reno_context @@ -361,7 +399,7 @@ 0 - 12 + 13 reno_context @@ -400,44 +438,6 @@ 0 - - - 0 - - 13 - - reno_context - - - - - - - 0 - - - - - - 1 - - - - - <string>transporting of arbitrary data to the catch site</string> - - - tutorial_transporting_data - - - - - - 1 - 2 - (:include include:) (:auto also:) - - 0 @@ -720,15 +720,6 @@ 2 (:include include:) (:auto also explicit=" 1 - - 0 - - -10 - - - 2 - - 1 0 @@ -741,7 +732,16 @@ 0 - -9 + -12 + + + 2 + + 1 + + 0 + + -10 2 @@ -1125,6 +1125,55 @@ reno_context + + + + + + 2 + 9748FFBBC9F02FEB97E0BA1E6280C51FFF5D7F217F0F12EE8ED29F6BE5CCCE44 + 2533933282 + 8724 + 615 + 9F3671DA5E8AB414F1FBA3B160D49134EAEE8DFF33E95376EDB41534E916FF38 + 2436936467 + 718 + 1496 + + + + + + 0 + ../../../../boost/exception_ptr.hpp + 0 + 0 + + + + + <string>unknown_exception</string> + + + + + + + + + 1 + 2 + (:include include:) (:auto also:) + + + + + 0 + + 29 + + reno_context + @@ -1170,7 +1219,7 @@ 0 - 29 + 30 reno_context @@ -1208,7 +1257,7 @@ 0 - 30 + 31 reno_context @@ -1246,7 +1295,7 @@ 0 - 31 + 32 reno_context @@ -1295,7 +1344,7 @@ 0 - 32 + 33 reno_context @@ -1344,7 +1393,7 @@ 0 - 33 + 34 reno_context @@ -1382,7 +1431,7 @@ 0 - 34 + 35 reno_context @@ -1431,7 +1480,7 @@ 0 - 35 + 36 reno_context @@ -1480,7 +1529,7 @@ 0 - 36 + 37 reno_context @@ -1519,55 +1568,6 @@ 0 - - - 0 - - 37 - - reno_context - - - - - - - 2 - 9748FFBBC9F02FEB97E0BA1E6280C51FFF5D7F217F0F12EE8ED29F6BE5CCCE44 - 2533933282 - 8724 - 615 - 9F3671DA5E8AB414F1FBA3B160D49134EAEE8DFF33E95376EDB41534E916FF38 - 2436936467 - 718 - 1496 - - - - - - 0 - ../../../../boost/exception_ptr.hpp - 0 - 0 - - - - - <string>unknown_exception</string> - - - - - - - - - 1 - 2 - (:include include:) (:auto also:) - - 0 @@ -1625,6 +1625,49 @@ reno_context + + + + + + 1 + E444EE9697EEADFDE0767E1D0242FC0E70D98E61FB1F0FFA099648DE509B82F3 + 94503238 + 773 + 374 + + + + + + 0 + ../../example/info_tuple.cpp + 0 + 0 + + + + + <string>adding grouped data to exceptions</string> + + + grouping_data + + + + + + 0 + + + + + 0 + + 40 + + reno_context + @@ -1659,7 +1702,7 @@ 0 - 40 + 41 reno_context @@ -1702,7 +1745,7 @@ 0 - 41 + 42 reno_context @@ -1747,7 +1790,50 @@ 0 - 42 + 43 + + reno_context + + + + + + + 1 + D10E536B909EFFF78FB09E6242AEC7C74ACDD75AE7DF32B45870422B752E5D8E + 1903336130 + 557 + 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 + + 44 reno_context @@ -1800,7 +1886,7 @@ 0 - 43 + 45 reno_context @@ -1853,7 +1939,45 @@ 0 - 44 + 46 + + reno_context + + + + + + + 0 + + + + + + 1 + + + + + <string>Synopsis</string> + + + synopsis + + + + + + 1 + 2 + (:include include:) (:auto also:) + + + + + 0 + + 47 reno_context @@ -1891,7 +2015,7 @@ 0 - 45 + 48 reno_context @@ -1936,7 +2060,7 @@ 0 - 46 + 49 reno_context @@ -1981,7 +2105,7 @@ 0 - 47 + 50 reno_context @@ -2034,7 +2158,7 @@ 0 - 48 + 51 reno_context @@ -2072,7 +2196,7 @@ 0 - 49 + 52 reno_context @@ -2110,7 +2234,7 @@ 0 - 50 + 53 reno_context @@ -2159,7 +2283,7 @@ 0 - 51 + 54 reno_context @@ -2197,7 +2321,7 @@ 0 - 52 + 55 reno_context @@ -2242,7 +2366,7 @@ 0 - 53 + 56 reno_context @@ -2287,7 +2411,7 @@ 0 - 54 + 57 reno_context @@ -2332,7 +2456,7 @@ 0 - 55 + 58 reno_context @@ -2370,7 +2494,7 @@ 0 - 56 + 59 reno_context @@ -2415,50 +2539,7 @@ 0 - 57 - - reno_context - - - - - - - 1 - D10E536B909EFFF78FB09E6242AEC7C74ACDD75AE7DF32B45870422B752E5D8E - 1903336130 - 557 - 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 - - 58 + 60 reno_context @@ -2497,87 +2578,6 @@ 0 - - - 0 - - 59 - - reno_context - - - - - - - 1 - E444EE9697EEADFDE0767E1D0242FC0E70D98E61FB1F0FFA099648DE509B82F3 - 94503238 - 773 - 374 - - - - - - 0 - ../../example/info_tuple.cpp - 0 - 0 - - - - - <string>adding grouped data to exceptions</string> - - - grouping_data - - - - - - 0 - - - - - 0 - - 60 - - reno_context - - - - - - - 0 - - - - - - 1 - - - - - <string>Synopsis</string> - - - synopsis - - - - - - 1 - 2 - (:include include:) (:auto also:) - - @@ -2918,6 +2918,17 @@ -34 + + 0 + + + + + 0 + + -35 + + 7 2 @@ -2926,7 +2937,7 @@ 0 - -34 + -35 2 @@ -2935,7 +2946,7 @@ 0 - -42 + -44 2 @@ -2955,7 +2966,7 @@ 0 - -35 + -36 @@ -2966,7 +2977,7 @@ 0 - -35 + -36 2 @@ -2975,7 +2986,7 @@ 0 - -47 + -50 2 @@ -2984,7 +2995,7 @@ 0 - -5 + -6 2 @@ -2993,24 +3004,13 @@ 0 - -43 + -45 2 decl pre_indent="4":) };@] - - - 0 - - -36 - - - - 0 - - 0 @@ -3502,7 +3502,7 @@ 0 - -34 + -35 2 @@ -3511,7 +3511,7 @@ 0 - -35 + -36 2 @@ -3520,7 +3520,7 @@ 0 - -35 + -36 2 @@ -3529,7 +3529,7 @@ 0 - -35 + -36 2 @@ -3538,7 +3538,7 @@ 0 - -35 + -36 2 @@ -3560,7 +3560,7 @@ 0 - -28 + -29 2 @@ -3761,6 +3761,17 @@ -41 + + 0 + + + + + 0 + + -42 + + 5 2 @@ -3785,17 +3796,6 @@ decl:)@] - - - 0 - - -42 - - - - 0 - - 0 @@ -3826,18 +3826,7 @@ - 3 - 2 - [@(:include - 1 - - 0 - - -15 - - - 2 - decl:)@] + 0 @@ -3848,72 +3837,7 @@ - 15 - 2 - [@#include <(:link - 1 - - 0 - - -41 - - - 2 - :)> #include <(:link - 1 - - 0 - - -50 - - - 2 - :)> #include <(:link - 1 - - 0 - - -23 - - - 2 - :)> #include <(:link - 1 - - 0 - - -24 - - - 2 - :)> #include <(:link - 1 - - 0 - - -52 - - - 2 - :)> #include <(:link - 1 - - 0 - - -45 - - - 2 - :)> #include <(:link - 1 - - 0 - - -53 - - - 2 - :)>@] + 0 @@ -3942,7 +3866,7 @@ 0 - -7 + -15 2 @@ -3957,7 +3881,72 @@ - 0 + 15 + 2 + [@#include <(:link + 1 + + 0 + + -42 + + + 2 + :)> #include <(:link + 1 + + 0 + + -53 + + + 2 + :)> #include <(:link + 1 + + 0 + + -23 + + + 2 + :)> #include <(:link + 1 + + 0 + + -24 + + + 2 + :)> #include <(:link + 1 + + 0 + + -55 + + + 2 + :)> #include <(:link + 1 + + 0 + + -48 + + + 2 + :)> #include <(:link + 1 + + 0 + + -56 + + + 2 + :)>@] @@ -3968,18 +3957,7 @@ - 3 - 2 - [@(:include - 1 - - 0 - - -35 - - - 2 - decl:)@] + 0 @@ -3990,40 +3968,31 @@ - 0 - - - - - 0 - - -52 - - - - 5 + 3 2 [@(:include 1 0 - -35 - - - 2 - def:) (:include - 1 - - 0 - - -6 + -8 2 decl:)@] + + + 0 + + -52 + + + + 0 + + 0 @@ -4031,6 +4000,70 @@ -53 + + 3 + 2 + [@(:include + 1 + + 0 + + -36 + + + 2 + decl:)@] + + + + + 0 + + -54 + + + + 0 + + + + + 0 + + -55 + + + + 5 + 2 + [@(:include + 1 + + 0 + + -36 + + + 2 + def:) (:include + 1 + + 0 + + -7 + + + 2 + decl:)@] + + + + + 0 + + -56 + + 11 2 @@ -4039,7 +4072,7 @@ 0 - -37 + -28 2 @@ -4048,7 +4081,7 @@ 0 - -8 + -9 2 @@ -4075,7 +4108,7 @@ 0 - -32 + -33 2 @@ -4086,7 +4119,7 @@ 0 - -54 + -57 @@ -4106,57 +4139,13 @@ 0 - -31 + -32 2 decl:) }@] - - - 0 - - -55 - - - - 0 - - - - - 0 - - -56 - - - - 3 - 2 - [@(:include - 1 - - 0 - - -38 - - - 2 - decl:)@] - - - - - 0 - - -57 - - - - 0 - - 0 @@ -4176,7 +4165,18 @@ - 0 + 3 + 2 + [@(:include + 1 + + 0 + + -38 + + + 2 + decl:)@] @@ -4212,27 +4212,7 @@ - 5 - 2 - [@(:link - 1 - - 0 - - -5 - - - 2 - mod="m":)( (:link - 1 - - 0 - - -47 - - - 2 - mod="m":) const & v );@] + 0 @@ -4245,7 +4225,7 @@ 5 2 - [@template <class E, class Tag, class T> E const & (:link + [@(:link 1 0 @@ -4254,16 +4234,16 @@ 2 - mod="/":)( E const & x, (:link + mod="m":)( (:link 1 0 - -35 + -50 2 - :)<Tag,T> const & v );@] + mod="m":) const & v );@] @@ -4274,9 +4254,9 @@ - 3 + 5 2 - [@template <class T> ---unspecified--- (:link + [@template <class E, class Tag, class T> E const & (:link 1 0 @@ -4285,7 +4265,16 @@ 2 - :)( T const & x );@] + mod="/":)( E const & x, (:link + 1 + + 0 + + -36 + + + 2 + :)<Tag,T> const & v );@] @@ -4298,7 +4287,7 @@ 3 2 - [@typedef ---unspecified--- (:link + [@template <class T> ---unspecified--- (:link 1 0 @@ -4307,7 +4296,7 @@ 2 - :);@] + :)( T const & x );@] @@ -4318,7 +4307,18 @@ - 0 + 3 + 2 + [@typedef ---unspecified--- (:link + 1 + + 0 + + -9 + + + 2 + :);@] @@ -4380,7 +4380,7 @@ 0 - -8 + -9 2 @@ -4420,7 +4420,7 @@ 0 - -35 + -36 2 @@ -4429,7 +4429,7 @@ 0 - -35 + -36 2 @@ -4502,7 +4502,7 @@ 0 - -31 + -32 2 @@ -4511,7 +4511,7 @@ 0 - -7 + -8 2 @@ -4556,7 +4556,7 @@ 0 - -31 + -32 2 @@ -4622,7 +4622,7 @@ 0 - -8 + -9 2 @@ -4723,9 +4723,9 @@ - 3 + 5 2 - [@template <class ErrorInfo,class E> typename ErrorInfo::value_type const * (:link + [@class (:link 1 0 @@ -4734,7 +4734,16 @@ 2 - :)( E const & x );@] + :): public std::exception public boost:: + 1 + + 0 + + -35 + + + 2 + { ---unspecified--- };@] @@ -4745,7 +4754,27 @@ - 0 + 5 + 2 + [@template <class ErrorInfo,class E> typename ErrorInfo::(:link + 1 + + 0 + + -50 + + + 2 + mod="m":) const * (:link + 1 + + 0 + + -29 + + + 2 + :)( E const & x );@] @@ -4767,27 +4796,7 @@ - 5 - 2 - [@#ifdef BOOST_NO_EXCEPTIONS void (:link - 1 - - 0 - - -31 - - - 2 - :)( std::exception const & e ); // user defined #else template <class E> void (:link - 1 - - 0 - - -31 - - - 2 - :)( E const & e ); #endif@] + 0 @@ -4800,7 +4809,7 @@ 5 2 - [@void (:link + [@#ifdef BOOST_NO_EXCEPTIONS void (:link 1 0 @@ -4809,16 +4818,16 @@ 2 - :)( (:link + :)( std::exception const & e ); // user defined #else template <class E> void (:link 1 0 - -8 + -32 2 - :) const & ep ); + :)( E const & e ); #endif@] @@ -4829,7 +4838,27 @@ - 0 + 5 + 2 + [@void (:link + 1 + + 0 + + -33 + + + 2 + :)( (:link + 1 + + 0 + + -9 + + + 2 + :) const & ep ); @@ -4840,18 +4869,7 @@ - 3 - 2 - [@class (:link - 1 - - 0 - - -34 - - - 2 - :);@] + 0 @@ -4864,7 +4882,7 @@ 3 2 - [@template <class Tag,class T> class (:link + [@class (:link 1 0 @@ -4884,7 +4902,18 @@ - 0 + 3 + 2 + [@template <class Tag,class T> class (:link + 1 + + 0 + + -36 + + + 2 + :);@] @@ -4895,27 +4924,7 @@ - 5 - 2 - [@class (:link - 1 - - 0 - - -37 - - - 2 - :): public std::exception public boost:: - 1 - - 0 - - -34 - - - 2 - { ---unspecified--- };@] + 0 @@ -4981,36 +4990,7 @@ - 7 - 2 - [@(:link - 1 - - 0 - - -42 - - - 2 - mod="m":)(); (:link - 1 - - 0 - - -42 - - - 2 - mod="m":)( (:link - 1 - - 0 - - -34 - - - 2 - :) const & x );@] + 0 @@ -5021,27 +5001,7 @@ - 5 - 2 - [@(:link - 1 - - 0 - - -47 - - - 2 - mod="m":) const & (:link - 1 - - 0 - - -43 - - - 2 - mod="m":)() const;@] + 0 @@ -5052,7 +5012,36 @@ - 0 + 7 + 2 + [@(:link + 1 + + 0 + + -44 + + + 2 + mod="m":)(); (:link + 1 + + 0 + + -44 + + + 2 + mod="m":)( (:link + 1 + + 0 + + -35 + + + 2 + :) const & x );@] @@ -5063,7 +5052,27 @@ - 0 + 5 + 2 + [@(:link + 1 + + 0 + + -50 + + + 2 + mod="m":) const & (:link + 1 + + 0 + + -45 + + + 2 + mod="m":)() const;@] @@ -5085,18 +5094,7 @@ - 3 - 2 - [@typedef T (:link - 1 - - 0 - - -47 - - - 2 - mod="m":);@] + 0 @@ -5129,7 +5127,18 @@ - 0 + 3 + 2 + [@typedef T (:link + 1 + + 0 + + -50 + + + 2 + mod="m":);@] @@ -5264,9 +5273,9 @@ - 3 + 11 2 - (:auto !!!:) (:include synopsis:) !!!!Effects: Stores a copy of v in the + (:auto !!:) All exception types that derive from boost::(:link 1 0 @@ -5275,7 +5284,43 @@ 2 - object. (:include throws:) + :) can be used as type-safe containers of arbitrary data objects, while complying with the no-throw requirements (15.5.1) of the ANSI C++ standard for exception types. When exceptions derive from boost::(:link + 1 + + 0 + + -35 + + + 2 + :), arbitrary data can be added to exception objects: *At the point of the throw; *At a later time as exceptions bubble up the call stack. (:include + 1 + + 0 + + -43 + + + 2 + :) (:include + 1 + + 0 + + -41 + + + 2 + :) (:include + 1 + + 0 + + -39 + + + 2 + :) @@ -5286,36 +5331,18 @@ - 7 + 3 2 - (:auto !!!:) (:include synopsis:) !!!!Requirements: E must be boost::(:link + (:auto !!!:) (:include synopsis:) !!!!Effects: Stores a copy of v in the 1 0 - -34 + -36 2 - :), or a type that derives (indirectly) from boost::(:link - 1 - - 0 - - -34 - - - 2 - :). !!!!Effects: Stores a copy of v into x. If x already contains data of type (:link - 1 - - 0 - - -35 - - - 2 - :)<Tag,T>, that data is overwritten. !!!!Returns: x. (:include throws:) + object. (:include throws:) @@ -5326,27 +5353,36 @@ - 5 + 7 2 - (:auto !!!:) (:include synopsis:) !!!!Requirements: T must be a class with an accessible no-throw copy constructor as per (15.5.1). !!!!Returns: * If T derives from boost::(:link + (:auto !!!:) (:include synopsis:) !!!!Requirements: E must be boost::(:link 1 0 - -34 + -35 2 - :), the returned object is of type T and is a copy of x. * Otherwise, the returned object is of an unspecified type that derives publicly from both T and boost::(:link + :), or a type that derives (indirectly) from boost::(:link 1 0 - -34 + -35 2 - :). The T sub-object is initialized from x by the T copy constructor. !!!!Throws: Nothing. + :). !!!!Effects: Stores a copy of v into x. If x already contains data of type (:link + 1 + + 0 + + -36 + + + 2 + :)<Tag,T>, that data is overwritten. !!!!Returns: x. (:include throws:) @@ -5356,6 +5392,37 @@ -8 + + 5 + 2 + (:auto !!!:) (:include synopsis:) !!!!Requirements: T must be a class with an accessible no-throw copy constructor as per (15.5.1). !!!!Returns: * If T derives from boost::(:link + 1 + + 0 + + -35 + + + 2 + :), the returned object is of type T and is a copy of x. * Otherwise, the returned object is of an unspecified type that derives publicly from both T and boost::(:link + 1 + + 0 + + -35 + + + 2 + :). The T sub-object is initialized from x by the T copy constructor. !!!!Throws: Nothing. + + + + + 0 + + -9 + + 17 2 @@ -5364,7 +5431,7 @@ 0 - -8 + -9 2 @@ -5373,7 +5440,7 @@ 0 - -8 + -9 2 @@ -5382,7 +5449,7 @@ 0 - -8 + -9 2 @@ -5391,7 +5458,7 @@ 0 - -8 + -9 2 @@ -5400,7 +5467,7 @@ 0 - -8 + -9 2 @@ -5409,7 +5476,7 @@ 0 - -8 + -9 2 @@ -5427,7 +5494,7 @@ 0 - -32 + -33 2 @@ -5438,7 +5505,7 @@ 0 - -9 + -10 @@ -5449,7 +5516,7 @@ 0 - -34 + -35 2 @@ -5458,7 +5525,7 @@ 0 - -35 + -36 2 @@ -5467,7 +5534,7 @@ 0 - -6 + -7 2 @@ -5476,7 +5543,7 @@ 0 - -6 + -7 2 @@ -5485,7 +5552,7 @@ 0 - -6 + -7 2 @@ -5494,7 +5561,7 @@ 0 - -35 + -36 2 @@ -5503,66 +5570,12 @@ 0 - -34 + -35 2 :) & e ) { e (:link 1 - - 0 - - -6 - - - 2 - |<<:) foo_info(foo); throw e; //Compile error: boost::(:link - 1 - - 0 - - -34 - - - 2 - :) is abstract }@] The correct code is: [@catch( boost::(:link - 1 - - 0 - - -34 - - - 2 - :) & e ) { e (:link - 1 - - 0 - - -6 - - - 2 - |<<:) foo_info(foo); throw; //Okay, re-throwing the original exception object. }@] !!!Why doesn't boost::exception derive from std::exception? Despite that (:link - 1 - - 0 - - -33 - - - 2 - |virtual inheritance should be used in deriving from base exception types:), many programmers fail to follow this principle when deriving from std::exception. If boost::(:link - 1 - - 0 - - -34 - - - 2 - :) derives from std::exception, using the - 1 0 @@ -5570,7 +5583,34 @@ 2 - function with such user-defined types would introduce dangerous ambiguity which would break all catch(std::exception &) statements. Of course, boost::(:link + |<<:) foo_info(foo); throw e; //Compile error: boost::(:link + 1 + + 0 + + -35 + + + 2 + :) is abstract }@] The correct code is: [@catch( boost::(:link + 1 + + 0 + + -35 + + + 2 + :) & e ) { e (:link + 1 + + 0 + + -7 + + + 2 + |<<:) foo_info(foo); throw; //Okay, re-throwing the original exception object. }@] !!!Why doesn't boost::exception derive from std::exception? Despite that (:link 1 0 @@ -5579,12 +5619,39 @@ 2 + |virtual inheritance should be used in deriving from base exception types:), many programmers fail to follow this principle when deriving from std::exception. If boost::(:link + 1 + + 0 + + -35 + + + 2 + :) derives from std::exception, using the + 1 + + 0 + + -8 + + + 2 + function with such user-defined types would introduce dangerous ambiguity which would break all catch(std::exception &) statements. Of course, boost::(:link + 1 + + 0 + + -35 + + + 2 :) should not be used to replace std::exception as a base type in exception type hierarchies. Instead, it should be included as a virtual base, in addition to std::exception (which should also be derived virtually.) !!!What is the space overhead of the boost::exception base class? The space overhead for the boost::exception data members is negligible in the context of exception handling. Throwing objects that derive from boost::(:link 1 0 - -34 + -35 2 @@ -5593,7 +5660,7 @@ 0 - -34 + -35 2 @@ -5602,7 +5669,7 @@ 0 - -31 + -32 2 @@ -5611,7 +5678,7 @@ 0 - -34 + -35 2 @@ -5620,7 +5687,7 @@ 0 - -31 + -32 2 @@ -5629,7 +5696,7 @@ 0 - -34 + -35 2 @@ -5638,7 +5705,7 @@ 0 - -8 + -9 2 @@ -5656,7 +5723,7 @@ 0 - -31 + -32 2 @@ -5703,7 +5770,7 @@ 0 - -10 + -11 @@ -5714,7 +5781,7 @@ 0 - -34 + -35 2 @@ -5723,7 +5790,7 @@ 0 - -34 + -35 2 @@ -5732,7 +5799,7 @@ 0 - -34 + -35 2 @@ -5743,7 +5810,7 @@ 0 - -11 + -12 @@ -5754,7 +5821,7 @@ 0 - -34 + -35 2 @@ -5763,7 +5830,7 @@ 0 - -7 + -8 2 @@ -5772,7 +5839,7 @@ 0 - -34 + -35 2 @@ -5781,7 +5848,7 @@ 0 - -46 + -49 2 @@ -5790,7 +5857,7 @@ 0 - -35 + -36 2 @@ -5799,7 +5866,7 @@ 0 - -35 + -36 2 @@ -5808,7 +5875,7 @@ 0 - -35 + -36 2 @@ -5817,7 +5884,7 @@ 0 - -7 + -8 2 @@ -5826,7 +5893,7 @@ 0 - -7 + -8 2 @@ -5835,7 +5902,7 @@ 0 - -34 + -35 2 @@ -5844,7 +5911,7 @@ 0 - -6 + -7 2 @@ -5853,7 +5920,7 @@ 0 - -34 + -35 2 @@ -5862,7 +5929,7 @@ 0 - -13 + -5 2 @@ -5873,7 +5940,7 @@ 0 - -12 + -13 @@ -5893,7 +5960,7 @@ 0 - -8 + -9 2 @@ -5902,7 +5969,7 @@ 0 - -53 + -56 2 @@ -5911,7 +5978,7 @@ 0 - -34 + -35 2 @@ -5920,7 +5987,7 @@ 0 - -8 + -9 2 @@ -5929,7 +5996,7 @@ 0 - -8 + -9 2 @@ -5956,7 +6023,7 @@ 0 - -32 + -33 2 @@ -5965,7 +6032,7 @@ 0 - -8 + -9 2 @@ -5974,7 +6041,7 @@ 0 - -32 + -33 2 @@ -5992,7 +6059,7 @@ 0 - -8 + -9 2 @@ -6010,7 +6077,7 @@ 0 - -8 + -9 2 @@ -6019,7 +6086,7 @@ 0 - -37 + -28 2 @@ -6037,71 +6104,13 @@ 0 - -32 + -33 2 :) in the above examples is well-formed. - - - 0 - - -13 - - - - 11 - 2 - (:auto !!:) All exception types that derive from boost::(:link - 1 - - 0 - - -34 - - - 2 - :) can be used as type-safe containers of arbitrary data objects, while complying with the no-throw requirements (15.5.1) of the ANSI C++ standard for exception types. When exceptions derive from boost::(:link - 1 - - 0 - - -34 - - - 2 - :), arbitrary data can be added to exception objects: *At the point of the throw; *At a later time as exceptions bubble up the call stack. (:include - 1 - - 0 - - -57 - - - 2 - :) (:include - 1 - - 0 - - -40 - - - 2 - :) (:include - 1 - - 0 - - -59 - - - 2 - :) - - 0 @@ -6148,7 +6157,7 @@ 0 - -34 + -35 2 @@ -6157,7 +6166,7 @@ 0 - -34 + -35 2 @@ -6179,7 +6188,7 @@ 0 - -28 + -29 2 @@ -6188,7 +6197,7 @@ 0 - -28 + -29 2 @@ -6197,7 +6206,7 @@ 0 - -34 + -35 2 @@ -6215,7 +6224,7 @@ 0 - -7 + -8 2 @@ -6224,7 +6233,7 @@ 0 - -31 + -32 2 @@ -6233,7 +6242,7 @@ 0 - -54 + -57 2 @@ -6255,7 +6264,7 @@ 0 - -8 + -9 2 @@ -6291,7 +6300,7 @@ 0 - -8 + -9 2 @@ -6300,7 +6309,7 @@ 0 - -37 + -28 2 @@ -6318,7 +6327,7 @@ 0 - -31 + -32 2 @@ -6327,7 +6336,7 @@ 0 - -34 + -35 2 @@ -6336,7 +6345,7 @@ 0 - -8 + -9 2 @@ -6358,7 +6367,7 @@ 0 - -31 + -32 2 @@ -6367,7 +6376,7 @@ 0 - -28 + -29 2 @@ -6398,7 +6407,7 @@ 0 - -34 + -35 2 @@ -6407,7 +6416,7 @@ 0 - -34 + -35 2 @@ -6416,7 +6425,7 @@ 0 - -35 + -36 2 @@ -6425,7 +6434,7 @@ 0 - -6 + -7 2 @@ -6434,7 +6443,7 @@ 0 - -34 + -35 2 @@ -6443,7 +6452,7 @@ 0 - -35 + -36 2 @@ -6452,7 +6461,7 @@ 0 - -34 + -35 2 @@ -6461,7 +6470,7 @@ 0 - -6 + -7 2 @@ -6470,7 +6479,7 @@ 0 - -34 + -35 2 @@ -6479,7 +6488,7 @@ 0 - -6 + -7 2 @@ -6488,7 +6497,7 @@ 0 - -34 + -35 2 @@ -6497,7 +6506,7 @@ 0 - -28 + -29 2 @@ -6506,7 +6515,7 @@ 0 - -28 + -29 2 @@ -6524,7 +6533,7 @@ 0 - -35 + -36 2 @@ -6533,7 +6542,7 @@ 0 - -34 + -35 2 @@ -6564,7 +6573,7 @@ 0 - -34 + -35 2 @@ -6573,7 +6582,7 @@ 0 - -34 + -35 2 @@ -6582,7 +6591,7 @@ 0 - -6 + -7 2 @@ -6591,7 +6600,7 @@ 0 - -46 + -49 2 @@ -6600,7 +6609,7 @@ 0 - -34 + -35 2 @@ -6609,7 +6618,7 @@ 0 - -34 + -35 2 @@ -6627,7 +6636,7 @@ 0 - -58 + -60 2 @@ -6649,7 +6658,7 @@ 0 - -34 + -35 2 @@ -6658,7 +6667,7 @@ 0 - -35 + -36 2 @@ -6667,7 +6676,7 @@ 0 - -34 + -35 2 @@ -6676,7 +6685,7 @@ 0 - -6 + -7 2 @@ -6685,7 +6694,7 @@ 0 - -34 + -35 2 @@ -6703,7 +6712,7 @@ 0 - -35 + -36 2 @@ -6712,7 +6721,7 @@ 0 - -35 + -36 2 @@ -6721,7 +6730,7 @@ 0 - -35 + -36 2 @@ -6730,7 +6739,7 @@ 0 - -43 + -45 2 @@ -6739,7 +6748,7 @@ 0 - -43 + -45 2 @@ -6757,7 +6766,7 @@ 0 - -35 + -36 2 @@ -6766,7 +6775,7 @@ 0 - -58 + -60 2 @@ -6797,7 +6806,7 @@ 0 - -8 + -9 2 @@ -6806,7 +6815,7 @@ 0 - -8 + -9 2 @@ -6860,7 +6869,7 @@ 0 - -8 + -9 2 @@ -6869,7 +6878,7 @@ 0 - -37 + -28 2 @@ -6878,7 +6887,7 @@ 0 - -34 + -35 2 @@ -6887,7 +6896,7 @@ 0 - -34 + -35 2 @@ -6896,7 +6905,7 @@ 0 - -37 + -28 2 @@ -6905,7 +6914,7 @@ 0 - -34 + -35 2 @@ -6953,7 +6962,7 @@ 0 - -34 + -35 2 @@ -6988,7 +6997,7 @@ 0 - -34 + -35 2 @@ -7029,6 +7038,37 @@ -28 + + 5 + 2 + (:auto !!!:) (:include synopsis:) This type is used by the (:link + 1 + + 0 + + -9 + + + 2 + :) support in Boost Exception. Please see (:link + 1 + + 0 + + -22 + + + 2 + :). + + + + + 0 + + -29 + + 13 2 @@ -7037,7 +7077,7 @@ 0 - -35 + -36 2 @@ -7046,7 +7086,7 @@ 0 - -34 + -35 2 @@ -7055,7 +7095,7 @@ 0 - -6 + -7 2 @@ -7064,7 +7104,7 @@ 0 - -28 + -29 2 @@ -7073,7 +7113,7 @@ 0 - -28 + -29 2 @@ -7093,7 +7133,7 @@ 0 - -29 + -30 @@ -7104,7 +7144,7 @@ 0 - -30 + -31 2 @@ -7113,7 +7153,7 @@ 0 - -31 + -32 2 @@ -7131,7 +7171,25 @@ 0 - -13 + -5 + + + 2 + mod="w":) ##(:link + 1 + + 0 + + -12 + + + 2 + mod="w":) ##(:link + 1 + + 0 + + -31 2 @@ -7149,25 +7207,7 @@ 0 - -30 - - - 2 - mod="w":) ##(:link - 1 - - 0 - - -10 - - - 2 - mod="w":) ##(:link - 1 - - 0 - - -33 + -34 2 @@ -7185,7 +7225,7 @@ 0 - -34 + -35 2 @@ -7203,7 +7243,7 @@ 0 - -31 + -32 2 @@ -7212,7 +7252,7 @@ 0 - -35 + -36 2 @@ -7221,7 +7261,7 @@ 0 - -6 + -7 2 @@ -7239,7 +7279,7 @@ 0 - -28 + -29 2 @@ -7248,7 +7288,7 @@ 0 - -7 + -8 2 @@ -7257,7 +7297,7 @@ 0 - -8 + -9 2 @@ -7293,7 +7333,7 @@ 0 - -32 + -33 2 @@ -7302,7 +7342,7 @@ 0 - -37 + -28 2 @@ -7338,7 +7378,7 @@ 0 - -60 + -46 2 @@ -7347,7 +7387,7 @@ 0 - -49 + -52 2 @@ -7356,7 +7396,7 @@ 0 - -39 + -40 2 @@ -7365,7 +7405,7 @@ 0 - -44 + -47 2 @@ -7374,7 +7414,7 @@ 0 - -51 + -54 2 @@ -7392,7 +7432,7 @@ 0 - -9 + -10 2 @@ -7401,7 +7441,7 @@ 0 - -55 + -58 2 @@ -7412,7 +7452,7 @@ 0 - -30 + -31 @@ -7432,7 +7472,7 @@ 0 - -31 + -32 2 @@ -7441,7 +7481,7 @@ 0 - -34 + -35 2 @@ -7450,7 +7490,7 @@ 0 - -36 + -37 2 @@ -7459,7 +7499,7 @@ 0 - -12 + -13 2 @@ -7470,7 +7510,7 @@ 0 - -31 + -32 @@ -7481,7 +7521,7 @@ 0 - -31 + -32 2 @@ -7499,7 +7539,7 @@ 0 - -7 + -8 2 @@ -7508,7 +7548,7 @@ 0 - -31 + -32 2 @@ -7517,7 +7557,7 @@ 0 - -31 + -32 2 @@ -7526,7 +7566,7 @@ 0 - -31 + -32 2 @@ -7537,7 +7577,7 @@ 0 - -32 + -33 @@ -7550,7 +7590,7 @@ 0 - -33 + -34 @@ -7561,7 +7601,7 @@ 0 - -34 + -35 2 @@ -7570,7 +7610,7 @@ 0 - -10 + -11 2 @@ -7581,7 +7621,7 @@ 0 - -34 + -35 @@ -7592,7 +7632,7 @@ 0 - -34 + -35 2 @@ -7601,7 +7641,7 @@ 0 - -34 + -35 2 @@ -7610,7 +7650,7 @@ 0 - -35 + -36 2 @@ -7619,7 +7659,7 @@ 0 - -6 + -7 2 @@ -7628,7 +7668,7 @@ 0 - -34 + -35 2 @@ -7637,7 +7677,7 @@ 0 - -28 + -29 2 @@ -7648,7 +7688,7 @@ 0 - -35 + -36 @@ -7659,7 +7699,7 @@ 0 - -35 + -36 2 @@ -7668,7 +7708,7 @@ 0 - -6 + -7 2 @@ -7677,7 +7717,7 @@ 0 - -34 + -35 2 @@ -7686,7 +7726,7 @@ 0 - -50 + -53 2 @@ -7695,7 +7735,7 @@ 0 - -35 + -36 2 @@ -7704,7 +7744,7 @@ 0 - -50 + -53 2 @@ -7713,7 +7753,7 @@ 0 - -35 + -36 2 @@ -7722,7 +7762,7 @@ 0 - -50 + -53 2 @@ -7731,7 +7771,7 @@ 0 - -35 + -36 2 @@ -7740,7 +7780,7 @@ 0 - -6 + -7 2 @@ -7749,7 +7789,7 @@ 0 - -52 + -55 2 @@ -7758,7 +7798,7 @@ 0 - -34 + -35 2 @@ -7767,7 +7807,7 @@ 0 - -6 + -7 2 @@ -7776,7 +7816,7 @@ 0 - -28 + -29 2 @@ -7794,7 +7834,7 @@ 0 - -34 + -35 2 @@ -7803,7 +7843,7 @@ 0 - -34 + -35 2 @@ -7812,7 +7852,7 @@ 0 - -28 + -29 2 @@ -7823,7 +7863,7 @@ 0 - -36 + -37 @@ -7834,7 +7874,7 @@ 0 - -52 + -55 2 @@ -7843,7 +7883,7 @@ 0 - -34 + -35 2 @@ -7870,38 +7910,7 @@ 0 - -34 - - - 2 - :). - - - - - 0 - - -37 - - - - 5 - 2 - (:auto !!!:) (:include synopsis:) This type is used by the (:link - 1 - - 0 - - -8 - - - 2 - :) support in Boost Exception. Please see (:link - 1 - - 0 - - -22 + -35 2 @@ -7928,491 +7937,6 @@ -39 - - 1 - 2 - (:auto !!:) (:pagelist fmt="index" tags="type":) - - - - - 0 - - -40 - - - - 19 - 2 - (:auto !!!:) Sometimes the throw site does not have all the information that is needed at the catch site to make sense of what went wrong. Let's say we have an exception type file_read_error, which takes a file name in its constructor. Consider the following function: [@void file_read( FILE * f, void * buffer, size_t size ) { if( size!=fread(buffer,1,size,f) ) throw file_read_error(????); }@] How can the file_read function pass a file name to the exception type constructor? All it has is a FILE handle. Using boost::(:link - 1 - - 0 - - -34 - - - 2 - :) allows us to free the file_read function from the burden of storing the file name in exceptions it throws: [@#include <(:link - 1 - - 0 - - -46 - - - 2 - :)> #include <stdio.h> #include <errno.h> typedef boost::(:link - 1 - - 0 - - -35 - - - 2 - :)<struct tag_errno,int> errno_info; class file_read_error: public boost::(:link - 1 - - 0 - - -34 - - - 2 - :) { }; void file_read( FILE * f, void * buffer, size_t size ) { if( size!=fread(buffer,1,size,f) ) throw file_read_error() << errno_info(errno); }@] If file_read detects a failure, it throws an exception which contains the information that is available at the time, namely the errno. Other relevant information, such as the file name, can be added in a context higher up the call stack, where it is known naturally: [@#include <(:link - 1 - - 0 - - -46 - - - 2 - :)> #include <boost/shared_ptr.hpp> #include <stdio.h> #include <string> typedef boost::(:link - 1 - - 0 - - -35 - - - 2 - :)<struct tag_file_name,std::string> file_name_info; boost::shared_ptr<FILE> file_open( char const * file_name, char const * mode ); void file_read( FILE * f, void * buffer, size_t size ); void parse_file( char const * file_name ) { boost::shared_ptr<FILE> f = file_open(file_name,"rb"); assert(f); try { char buf[1024]; file_read( f.get(), buf, sizeof(buf) ); } catch( boost::(:link - 1 - - 0 - - -34 - - - 2 - :) & e ) { e << file_name_info(file_name); throw; } }@] The above function is (almost) exception-neutral -- if an exception is emitted by any function call within the try block, parse_file does not need to do any real work, but it intercepts any boost::(:link - 1 - - 0 - - -34 - - - 2 - :) object, stores the file name, and re-throws using a throw-expression with no operand (15.1.6). The rationale for catching any boost::(:link - 1 - - 0 - - -34 - - - 2 - :) object is that the file name is relevant to any failure that occurs in parse_file, ''even if the failure is unrelated to file I/O''. - - - - - 0 - - -41 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -42 - - - - 7 - 2 - (:auto !!!:) (:include decl:) !!!!Effects: * Default constructor: initializes an empty boost::(:link - 1 - - 0 - - -34 - - - 2 - :) object. * Copy constructor: initializes a boost::(:link - 1 - - 0 - - -34 - - - 2 - :) object which shares ownership with x of all data added through (:link - 1 - - 0 - - -6 - - - 2 - mod="/":), including data that is added at a future time. !!!!Throws: Nothing. - - - - - 0 - - -43 - - - - 5 - 2 - (:auto !!!:) (:include synopsis:) !!!!Description: Returns a const reference to the copy of the value passed to (:link - 1 - - 0 - - -35 - - - 2 - :)'s constructor stored in the (:link - 1 - - 0 - - -35 - - - 2 - :) object. !!!!Throws: Nothing. - - - - - 0 - - -44 - - - - 1 - 2 - (:auto !!:) (:pagelist fmt="index" tags="function":) - - - - - 0 - - -45 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -46 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -47 - - - - 5 - 2 - (:auto !!!:) (:include synopsis:) !!!!Definition: The expression - 1 - - 0 - - -35 - - - 2 - <Tag,T>::(:link - 1 - - 0 - - -47 - - - 2 - mod="m":) evaluates to T. - - - - - 0 - - -48 - - - - 1 - 2 - (:auto !!!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -49 - - - - 1 - 2 - (:auto !!:) (:pagelist fmt="index" tags="hpp" sort_prefix="6":) - - - - - 0 - - -50 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -51 - - - - 1 - 2 - (:auto !!:) (:pagelist tags="macro":) - - - - - 0 - - -52 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -53 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -54 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -55 - - - - 1 - 2 - (:auto !:) This is an alphabetical list of all Boost Exception documentation pages. (:pagelist fmt="index" except_tags="index noindex" mod="w":) - - - - - 0 - - -56 - - - - 1 - 2 - (:auto !!:) !!!Synopsis (:include synopsis:) - - - - - 0 - - -57 - - - - 17 - 2 - (:auto !!!:) The following example demonstrates how errno can be stored in exception objects using Boost Exception: [@#include <(:link - 1 - - 0 - - -46 - - - 2 - :)> #include <errno.h> #include <iostream> typedef boost::(:link - 1 - - 0 - - -35 - - - 2 - :)<struct tag_errno,int> errno_info; //(1) class my_error: public boost::(:link - 1 - - 0 - - -34 - - - 2 - :), public std::exception { }; //(2) void f() { throw my_error() << errno_info(errno); //(3) } @] First, we instantiate the (:link - 1 - - 0 - - -35 - - - 2 - :) template using a unique identifier -- tag_errno, and the type of the info it identifies -- int. This provides compile-time type safety for the various values stored in exception objects. Second, we define class my_error, which derives from boost::(:link - 1 - - 0 - - -34 - - - 2 - :). Finally, (3) illustrates how the typedef from (1) can be used with (:link - 1 - - 0 - - -6 - - - 2 - |operator<<:) to store values in exception objects at the point of the throw. The stored errno value can be recovered at a later time like this: [@// ...continued void g() { try { f(); } catch( my_error & x ) { if( int const * err=boost::(:link - 1 - - 0 - - -28 - - - 2 - :)<errno_info>(x) ) std::cerr << "Error code: " << *err; } }@] The (:link - 1 - - 0 - - -28 - - - 2 - :) 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, err will point to it; otherwise a null pointer is returned. - - - - - 0 - - -58 - - - - 3 - 2 - !!!!Example: this is a possible output from the (:link - 1 - - 0 - - -21 - - - 2 - :) function, as used in ''libs/exception/example/example_io.cpp:'' [@example_io.cpp(83): Throw in function class boost::shared_ptr<struct _iobuf> __cdecl my_fopen(const char *,const char *) Dynamic exception type: class boost::exception_detail::clone_impl<class fopen_error> std::exception::what: example_io error [struct tag_errno *] = 2, OS says "No such file or directory" [struct tag_file_name *] = tmp1.txt [struct tag_function *] = fopen [struct tag_open_mode *] = rb@] - - - - - 0 - - -59 - - 13 2 @@ -8421,7 +7945,7 @@ 0 - -45 + -48 2 @@ -8430,7 +7954,7 @@ 0 - -35 + -36 2 @@ -8439,7 +7963,7 @@ 0 - -35 + -36 2 @@ -8448,7 +7972,7 @@ 0 - -35 + -36 2 @@ -8457,7 +7981,7 @@ 0 - -34 + -35 2 @@ -8466,7 +7990,7 @@ 0 - -28 + -29 2 @@ -8477,7 +8001,283 @@ 0 - -60 + -40 + + + + 1 + 2 + (:auto !!:) (:pagelist fmt="index" tags="type":) + + + + + 0 + + -41 + + + + 19 + 2 + (:auto !!!:) Sometimes the throw site does not have all the information that is needed at the catch site to make sense of what went wrong. Let's say we have an exception type file_read_error, which takes a file name in its constructor. Consider the following function: [@void file_read( FILE * f, void * buffer, size_t size ) { if( size!=fread(buffer,1,size,f) ) throw file_read_error(????); }@] How can the file_read function pass a file name to the exception type constructor? All it has is a FILE handle. Using boost::(:link + 1 + + 0 + + -35 + + + 2 + :) allows us to free the file_read function from the burden of storing the file name in exceptions it throws: [@#include <(:link + 1 + + 0 + + -49 + + + 2 + :)> #include <stdio.h> #include <errno.h> typedef boost::(:link + 1 + + 0 + + -36 + + + 2 + :)<struct tag_errno,int> errno_info; class file_read_error: public boost::(:link + 1 + + 0 + + -35 + + + 2 + :) { }; void file_read( FILE * f, void * buffer, size_t size ) { if( size!=fread(buffer,1,size,f) ) throw file_read_error() << errno_info(errno); }@] If file_read detects a failure, it throws an exception which contains the information that is available at the time, namely the errno. Other relevant information, such as the file name, can be added in a context higher up the call stack, where it is known naturally: [@#include <(:link + 1 + + 0 + + -49 + + + 2 + :)> #include <boost/shared_ptr.hpp> #include <stdio.h> #include <string> typedef boost::(:link + 1 + + 0 + + -36 + + + 2 + :)<struct tag_file_name,std::string> file_name_info; boost::shared_ptr<FILE> file_open( char const * file_name, char const * mode ); void file_read( FILE * f, void * buffer, size_t size ); void parse_file( char const * file_name ) { boost::shared_ptr<FILE> f = file_open(file_name,"rb"); assert(f); try { char buf[1024]; file_read( f.get(), buf, sizeof(buf) ); } catch( boost::(:link + 1 + + 0 + + -35 + + + 2 + :) & e ) { e << file_name_info(file_name); throw; } }@] The above function is (almost) exception-neutral -- if an exception is emitted by any function call within the try block, parse_file does not need to do any real work, but it intercepts any boost::(:link + 1 + + 0 + + -35 + + + 2 + :) object, stores the file name, and re-throws using a throw-expression with no operand (15.1.6). The rationale for catching any boost::(:link + 1 + + 0 + + -35 + + + 2 + :) object is that the file name is relevant to any failure that occurs in parse_file, ''even if the failure is unrelated to file I/O''. + + + + + 0 + + -42 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -43 + + + + 17 + 2 + (:auto !!!:) The following example demonstrates how errno can be stored in exception objects using Boost Exception: [@#include <(:link + 1 + + 0 + + -49 + + + 2 + :)> #include <errno.h> #include <iostream> typedef boost::(:link + 1 + + 0 + + -36 + + + 2 + :)<struct tag_errno,int> errno_info; //(1) class my_error: public boost::(:link + 1 + + 0 + + -35 + + + 2 + :), public std::exception { }; //(2) void f() { throw my_error() << errno_info(errno); //(3) } @] First, we instantiate the (:link + 1 + + 0 + + -36 + + + 2 + :) template using a unique identifier -- tag_errno, and the type of the info it identifies -- int. This provides compile-time type safety for the various values stored in exception objects. Second, we define class my_error, which derives from boost::(:link + 1 + + 0 + + -35 + + + 2 + :). Finally, (3) illustrates how the typedef from (1) can be used with (:link + 1 + + 0 + + -7 + + + 2 + |operator<<:) to store values in exception objects at the point of the throw. The stored errno value can be recovered at a later time like this: [@// ...continued void g() { try { f(); } catch( my_error & x ) { if( int const * err=boost::(:link + 1 + + 0 + + -29 + + + 2 + :)<errno_info>(x) ) std::cerr << "Error code: " << *err; } }@] The (:link + 1 + + 0 + + -29 + + + 2 + :) 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, err will point to it; otherwise a null pointer is returned. + + + + + 0 + + -44 + + + + 7 + 2 + (:auto !!!:) (:include decl:) !!!!Effects: * Default constructor: initializes an empty boost::(:link + 1 + + 0 + + -35 + + + 2 + :) object. * Copy constructor: initializes a boost::(:link + 1 + + 0 + + -35 + + + 2 + :) object which shares ownership with x of all data added through (:link + 1 + + 0 + + -7 + + + 2 + mod="/":), including data that is added at a future time. !!!!Throws: Nothing. + + + + + 0 + + -45 + + + + 5 + 2 + (:auto !!!:) (:include synopsis:) !!!!Description: Returns a const reference to the copy of the value passed to (:link + 1 + + 0 + + -36 + + + 2 + :)'s constructor stored in the (:link + 1 + + 0 + + -36 + + + 2 + :) object. !!!!Throws: Nothing. + + + + + 0 + + -46 @@ -8506,7 +8306,7 @@ 0 - -50 + -53 2 @@ -8515,7 +8315,7 @@ 0 - -50 + -53 2 @@ -8524,7 +8324,7 @@ 0 - -52 + -55 2 @@ -8533,25 +8333,7 @@ 0 - -52 - - - 2 - synopsis:)@] `#include <(:link - 1 - - 0 - - -45 - - - 2 - :)> [@(:include - 1 - - 0 - - -45 + -55 2 @@ -8578,7 +8360,7 @@ 0 - -41 + -51 2 @@ -8587,7 +8369,43 @@ 0 - -41 + -51 + + + 2 + synopsis:)@] `#include <(:link + 1 + + 0 + + -42 + + + 2 + :)> [@(:include + 1 + + 0 + + -42 + + + 2 + synopsis:)@] `#include <(:link + 1 + + 0 + + -59 + + + 2 + :)> [@(:include + 1 + + 0 + + -59 2 @@ -8611,24 +8429,6 @@ 2 synopsis:)@] `#include <(:link 1 - - 0 - - -53 - - - 2 - :)> [@(:include - 1 - - 0 - - -53 - - - 2 - synopsis:)@] `#include <(:link - 1 0 @@ -8650,7 +8450,7 @@ 0 - -54 + -57 2 @@ -8659,7 +8459,7 @@ 0 - -54 + -57 2 @@ -8668,7 +8468,7 @@ 0 - -46 + -49 2 @@ -8677,13 +8477,222 @@ 0 - -46 + -49 2 synopsis:) + + + 0 + + -47 + + + + 1 + 2 + (:auto !!:) (:pagelist fmt="index" tags="function":) + + + + + 0 + + -48 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -49 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -50 + + + + 5 + 2 + (:auto !!!:) (:include synopsis:) !!!!Definition: The expression + 1 + + 0 + + -36 + + + 2 + <Tag,T>::(:link + 1 + + 0 + + -50 + + + 2 + mod="m":) evaluates to T. + + + + + 0 + + -51 + + + + 1 + 2 + (:auto !!!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -52 + + + + 1 + 2 + (:auto !!:) (:pagelist fmt="index" tags="hpp" sort_prefix="6":) + + + + + 0 + + -53 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -54 + + + + 1 + 2 + (:auto !!:) (:pagelist tags="macro":) + + + + + 0 + + -55 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -56 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -57 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -58 + + + + 1 + 2 + (:auto !:) This is an alphabetical list of all Boost Exception documentation pages. (:pagelist fmt="index" except_tags="index noindex" mod="w":) + + + + + 0 + + -59 + + + + 1 + 2 + (:auto !!:) !!!Synopsis (:include synopsis:) + + + + + 0 + + -60 + + + + 3 + 2 + !!!!Example: this is a possible output from the (:link + 1 + + 0 + + -21 + + + 2 + :) function, as used in ''libs/exception/example/example_io.cpp:'' [@example_io.cpp(83): Throw in function class boost::shared_ptr<struct _iobuf> __cdecl my_fopen(const char *,const char *) Dynamic exception type: class boost::exception_detail::clone_impl<class fopen_error> std::exception::what: example_io error [struct tag_errno *] = 2, OS says "No such file or directory" [struct tag_file_name *] = tmp1.txt [struct tag_function *] = fopen [struct tag_open_mode *] = rb@] + + @@ -8706,9 +8715,7 @@ - 1 - 2 - !!!!Throws: Any exception emitted by v's copy constructor. + 0 @@ -8721,7 +8728,7 @@ 1 2 - !!!!Throws: std::bad_alloc, or any exception emitted by the T copy constructor. + !!!!Throws: Any exception emitted by v's copy constructor. @@ -8732,7 +8739,9 @@ - 0 + 1 + 2 + !!!!Throws: std::bad_alloc, or any exception emitted by the T copy constructor. @@ -9342,18 +9351,7 @@ - 3 - 2 - `#include <(:link - 1 - - 0 - - -52 - - - 2 - :)> [@(:include decl:)@] + 0 @@ -9371,11 +9369,11 @@ 0 - -52 + -55 2 - :)>\\ [@namespace boost { (:include decl pre_indent="4":) }@] + :)> [@(:include decl:)@] @@ -9388,16 +9386,16 @@ 3 2 - `#include < + `#include <(:link 1 0 - -48 + -55 2 - > [@namespace boost { (:include decl pre_indent="4":) }@] + :)>\\ [@namespace boost { (:include decl pre_indent="4":) }@] @@ -9410,16 +9408,16 @@ 3 2 - `#include <(:link + `#include < 1 0 - -53 + -51 2 - :)> [@namespace boost { (:include decl pre_indent="4":) }@] + > [@namespace boost { (:include decl pre_indent="4":) }@] @@ -9430,7 +9428,18 @@ - 0 + 3 + 2 + `#include <(:link + 1 + + 0 + + -56 + + + 2 + :)> [@namespace boost { (:include decl pre_indent="4":) }@] @@ -9492,7 +9501,7 @@ 0 - -53 + -56 2 @@ -9514,7 +9523,7 @@ 0 - -45 + -48 2 @@ -9578,7 +9587,7 @@ 0 - -54 + -57 2 @@ -9622,7 +9631,7 @@ 0 - -41 + -42 2 @@ -9644,7 +9653,7 @@ 0 - -53 + -56 2 @@ -9725,7 +9734,7 @@ 0 - -41 + -42 2 @@ -9740,9 +9749,18 @@ - 1 + 3 2 - [@namespace boost { (:include decl pre_indent="4":) }@] + `#include <(:link + 1 + + 0 + + -56 + + + 2 + :)> [@namespace boost { (:include decl pre_indent="4":) }@] @@ -9753,7 +9771,9 @@ - 0 + 1 + 2 + [@namespace boost { (:include decl pre_indent="4":) }@] @@ -9775,18 +9795,7 @@ - 3 - 2 - `#include <(:link - 1 - - 0 - - -54 - - - 2 - :)> [@namespace boost { (:include decl:) }@] + 0 @@ -9804,11 +9813,11 @@ 0 - -53 + -57 2 - :)> [@namespace boost { (:include decl pre_indent="4":) }@] + :)> [@namespace boost { (:include decl:) }@] @@ -9819,7 +9828,18 @@ - 0 + 3 + 2 + `#include <(:link + 1 + + 0 + + -56 + + + 2 + :)> [@namespace boost { (:include decl pre_indent="4":) }@] @@ -9829,6 +9849,17 @@ -34 + + 0 + + + + + 0 + + -35 + + 3 2 @@ -9848,7 +9879,7 @@ 0 - -35 + -36 @@ -9859,24 +9890,13 @@ 0 - -52 + -55 2 :)> [@namespace boost { (:include def pre_indent="4":) }@] - - - 0 - - -36 - - - - 0 - - 0 @@ -9885,18 +9905,7 @@ - 3 - 2 - `#include <(:link - 1 - - 0 - - -53 - - - 2 - :)> [@namespace boost { (:include decl pre_indent="4":) }@] + 0 @@ -9942,18 +9951,7 @@ - 3 - 2 - [@#include <string> namespace boost { (:include - 1 - - 0 - - -34 - - - 2 - decl pre_indent="4":) (:include api pre_indent="4":) }@] + 0 @@ -9964,7 +9962,18 @@ - 0 + 3 + 2 + [@#include <string> namespace boost { (:include + 1 + + 0 + + -35 + + + 2 + decl pre_indent="4":) (:include api pre_indent="4":) }@] @@ -9975,18 +9984,7 @@ - 3 - 2 - `#include <(:link - 1 - - 0 - - -52 - - - 2 - :)> [@(:include decl:)@] + 0 @@ -10007,6 +10005,50 @@ -45 + + 3 + 2 + `#include <(:link + 1 + + 0 + + -55 + + + 2 + :)> [@(:include decl:)@] + + + + + 0 + + -46 + + + + 0 + + + + + 0 + + -47 + + + + 0 + + + + + 0 + + -48 + + 3 2 @@ -10015,7 +10057,7 @@ 0 - -52 + -55 2 @@ -10026,7 +10068,7 @@ 0 - -46 + -49 @@ -10039,7 +10081,7 @@ 0 - -47 + -50 @@ -10050,7 +10092,7 @@ 0 - -52 + -55 2 @@ -10061,7 +10103,7 @@ 0 - -48 + -51 @@ -10079,41 +10121,6 @@ > namespace boost { (:include api pre_indent="4":) }@] - - - 0 - - -49 - - - - 0 - - - - - 0 - - -50 - - - - 1 - 2 - [@namespace boost { (:include api pre_indent="4":) }@] - - - - - 0 - - -51 - - - - 0 - - 0 @@ -10122,18 +10129,7 @@ - 3 - 2 - [@#include <(:link - 1 - - 0 - - -23 - - - 2 - :)> namespace boost { (:include api pre_indent="4":) }@] + 0 @@ -10143,6 +10139,30 @@ -53 + + 1 + 2 + [@namespace boost { (:include api pre_indent="4":) }@] + + + + + 0 + + -54 + + + + 0 + + + + + 0 + + -55 + + 3 2 @@ -10158,30 +10178,6 @@ :)> namespace boost { (:include api pre_indent="4":) }@] - - - 0 - - -54 - - - - 1 - 2 - (:include api:) - - - - - 0 - - -55 - - - - 0 - - 0 @@ -10190,9 +10186,18 @@ - 1 + 3 2 - [@namespace boost { (:include api pre_indent="4":) }@] + [@#include <(:link + 1 + + 0 + + -23 + + + 2 + :)> namespace boost { (:include api pre_indent="4":) }@] @@ -10203,7 +10208,9 @@ - 0 + 1 + 2 + (:include api:) @@ -10225,7 +10232,9 @@ - 0 + 1 + 2 + [@namespace boost { (:include api pre_indent="4":) }@] @@ -10430,23 +10439,6 @@ 56 - - - - - 0 - - - - - - 1 - - - - -29 - - @@ -10478,7 +10470,7 @@ - -13 + -31 @@ -10495,7 +10487,7 @@ - -55 + -5 @@ -10512,7 +10504,24 @@ - -48 + -58 + + + + + + + 0 + + + + + + 1 + + + + -51 @@ -10563,7 +10572,24 @@ - -33 + -34 + + + + + + + 0 + + + + + + 1 + + + + -11 @@ -10597,7 +10623,7 @@ - -9 + -47 @@ -10614,7 +10640,7 @@ - -44 + -52 @@ -10631,7 +10657,7 @@ - -49 + -40 @@ -10648,7 +10674,7 @@ - -39 + -54 @@ -10665,24 +10691,7 @@ - -51 - - - - - - - 0 - - - - - - 1 - - - - -60 + -46 @@ -10706,7 +10715,7 @@ - -12 + -13 @@ -10730,7 +10739,7 @@ - -58 + -60 @@ -10754,7 +10763,7 @@ - -11 + -12 @@ -10810,7 +10819,7 @@ - -37 + -28 @@ -10866,7 +10875,7 @@ - -8 + -9 @@ -10894,7 +10903,7 @@ - -32 + -33 @@ -10950,7 +10959,7 @@ - -28 + -29 @@ -10998,7 +11007,7 @@ - -46 + -49 @@ -11026,7 +11035,7 @@ - -5 + -6 @@ -11054,7 +11063,7 @@ - -6 + -7 @@ -11078,7 +11087,7 @@ - -57 + -43 @@ -11102,7 +11111,7 @@ - -54 + -57 @@ -11126,7 +11135,7 @@ - -52 + -55 @@ -11154,7 +11163,7 @@ - -31 + -32 @@ -11210,7 +11219,7 @@ - -56 + -59 @@ -11238,7 +11247,7 @@ - -35 + -36 @@ -11270,7 +11279,7 @@ - -47 + -50 @@ -11302,7 +11311,7 @@ - -43 + -45 @@ -11406,7 +11415,7 @@ - -53 + -56 @@ -11514,7 +11523,7 @@ - -7 + -8 @@ -11542,7 +11551,7 @@ - -34 + -35 @@ -11574,7 +11583,7 @@ - -42 + -44 @@ -11598,7 +11607,7 @@ - -45 + -48 @@ -11622,7 +11631,7 @@ - -36 + -37 @@ -11670,7 +11679,7 @@ - -40 + -41 @@ -11694,7 +11703,7 @@ - -41 + -42 @@ -11722,7 +11731,7 @@ - -50 + -53 @@ -11774,7 +11783,7 @@ - -59 + -39 @@ -11805,7 +11814,7 @@ -5 - function member + tutorial @@ -11814,7 +11823,7 @@ -6 - error_info free function + function member @@ -11832,16 +11841,16 @@ -8 - type + error_info free function 0 - -11 + -9 - tutorial + type @@ -11850,7 +11859,7 @@ -12 - noindex tutorial + tutorial @@ -11859,7 +11868,7 @@ -13 - tutorial + noindex tutorial @@ -11976,7 +11985,7 @@ -28 - error_info free function + exception_ptr type @@ -11985,7 +11994,7 @@ -29 - noindex + error_info free function @@ -11994,7 +12003,7 @@ -30 - tutorial + noindex @@ -12003,7 +12012,7 @@ -31 - free function + tutorial @@ -12012,7 +12021,7 @@ -32 - exception_ptr free function + free function @@ -12021,7 +12030,7 @@ -33 - tutorial + exception_ptr free function @@ -12030,7 +12039,7 @@ -34 - type + tutorial @@ -12048,7 +12057,7 @@ -36 - noindex tutorial + type @@ -12057,7 +12066,7 @@ -37 - exception_ptr type + noindex tutorial @@ -12072,7 +12081,7 @@ 0 - -40 + -39 noalso noindex tutorial @@ -12084,7 +12093,7 @@ -41 - + noalso noindex tutorial @@ -12093,7 +12102,7 @@ -42 - function + @@ -12102,7 +12111,16 @@ -43 - function member + noalso noindex tutorial + + + + 0 + + -44 + + + function @@ -12111,25 +12129,7 @@ -45 - - - - - 0 - - -46 - - - - - - - 0 - - -47 - - - type + function member @@ -12138,7 +12138,16 @@ -48 - error_info + + + + + 0 + + -49 + + + @@ -12147,16 +12156,16 @@ -50 - + type 0 - -52 + -51 - + error_info @@ -12167,15 +12176,6 @@ - - - 0 - - -54 - - - - 0 @@ -12201,7 +12201,16 @@ -57 - noalso noindex tutorial + + + + + 0 + + -58 + + + @@ -12210,7 +12219,7 @@ -59 - noalso noindex tutorial + diff --git a/doc/throw_exception.html b/doc/throw_exception.html index 70236df..cf4ef4b 100644 --- a/doc/throw_exception.html +++ b/doc/throw_exception.html @@ -26,17 +26,17 @@ boost { #ifdef BOOST_NO_EXCEPTIONS - void throw_exception( std::exception const & e ); // user defined + void throw_exception( std::exception const & e ); // user defined #else template <class E> - void throw_exception( E const & e ); + void throw_exception( E const & e ); #endif }

    Requirements:

    E must derive publicly from std::exception.

    Effects:

    -
    • If BOOST_NO_EXCEPTIONS is not defined, boost::throw_exception(e) is equivalent to throw boost::enable_current_exception(boost::enable_error_info(e)), unless BOOST_EXCEPTION_DISABLE is defined, in which case boost::throw_exception(e) is equivalent to throw e;
      • -
    • If BOOST_NO_EXCEPTIONS is defined, the function is left undefined, and the user is expected to supply an appropriate definition. Callers of throw_exception are allowed to assume that the function never returns; therefore, if the user-defined throw_exception returns, the behavior is undefined.
      • +
      • If BOOST_NO_EXCEPTIONS is not defined, boost::throw_exception(e) is equivalent to throw boost::enable_current_exception(boost::enable_error_info(e)), unless BOOST_EXCEPTION_DISABLE is defined, in which case boost::throw_exception(e) is equivalent to throw e;
        • +
      • If BOOST_NO_EXCEPTIONS is defined, the function is left undefined, and the user is expected to supply an appropriate definition. Callers of throw_exception are allowed to assume that the function never returns; therefore, if the user-defined throw_exception returns, the behavior is undefined.

    See Also:

    diff --git a/doc/tuple_operator_shl.html b/doc/tuple_operator_shl.html index dd3fec9..47c3d0f 100644 --- a/doc/tuple_operator_shl.html +++ b/doc/tuple_operator_shl.html @@ -26,7 +26,7 @@ boost { template <class E, class Tag1, class T1, ..., class TagN, class TN> - E const & operator<<( E const & x, + E const & operator<<( E const & x, tuple< error_info<Tag1,T1>, ..., diff --git a/doc/unknown_exception.html b/doc/unknown_exception.html index f9685da..d498d1e 100644 --- a/doc/unknown_exception.html +++ b/doc/unknown_exception.html @@ -26,7 +26,7 @@ boost { class - unknown_exception: + unknown_exception: public std::exception public boost::exception {