From 910c081d37a2371f5d022c6e509ba07ba1e3312a Mon Sep 17 00:00:00 2001 From: Emil Dotchevski Date: Thu, 22 Oct 2009 07:14:09 +0000 Subject: [PATCH] Added errinfo_nested_exception typedef. Documentation update. [SVN r57059] --- doc/BOOST_THROW_EXCEPTION.html | 8 +- doc/boost-exception.html | 2 - doc/boost_exception_all_hpp.html | 16 +- ..._exception_current_exception_cast_hpp.html | 7 +- ..._exception_diagnostic_information_hpp.html | 10 +- ...xception_enable_current_exception_hpp.html | 7 +- ...boost_exception_enable_error_info_hpp.html | 7 +- ...st_exception_errinfo_api_function_hpp.html | 7 +- doc/boost_exception_errinfo_at_line_hpp.html | 7 +- doc/boost_exception_errinfo_errno_hpp.html | 7 +- ...ost_exception_errinfo_file_handle_hpp.html | 7 +- ...boost_exception_errinfo_file_name_hpp.html | 7 +- ..._exception_errinfo_file_open_mode_hpp.html | 7 +- ...xception_errinfo_nested_exception_hpp.html | 51 + ..._exception_errinfo_type_info_name_hpp.html | 7 +- doc/boost_exception_error_info_hpp.html | 15 +- doc/boost_exception_exception_hpp.html | 13 +- doc/boost_exception_get_error_info_hpp.html | 7 +- doc/boost_exception_hpp.html | 2 - doc/boost_exception_info_hpp.html | 13 +- doc/boost_exception_info_tuple_hpp.html | 8 +- doc/boost_exception_ptr_hpp.html | 13 +- doc/boost_throw_exception_hpp.html | 9 +- doc/configuration_macros.html | 7 +- doc/copy_exception.html | 7 +- doc/current_exception.html | 13 +- doc/current_exception_cast.html | 7 +- ...rent_exception_diagnostic_information.html | 8 +- doc/diagnostic_information.html | 15 +- doc/diagnostic_information_what.html | 6 +- doc/enable_current_exception.html | 13 +- doc/enable_error_info.html | 12 +- doc/errinfo_api_function.html | 7 +- doc/errinfo_at_line.html | 6 +- doc/errinfo_errno.html | 7 +- doc/errinfo_file_handle.html | 6 +- doc/errinfo_file_name.html | 7 +- doc/errinfo_file_open_mode.html | 7 +- doc/errinfo_nested_exception.html | 52 + doc/errinfo_type_info_name.html | 6 +- doc/error_info.html | 39 +- doc/error_info_error_info.html | 6 +- doc/error_info_value.html | 7 +- doc/error_info_value_type.html | 8 +- doc/exception.html | 37 +- doc/exception_constructors.html | 6 +- doc/exception_destructor.html | 6 +- doc/exception_operator_shl.html | 16 +- doc/exception_ptr.html | 15 +- ...ception_types_as_simple_semantic_tags.html | 8 +- doc/frequently_asked_questions.html | 7 +- doc/functions.html | 6 +- doc/get_error_info.html | 14 +- doc/headers.html | 46 +- doc/macros.html | 9 +- doc/motivation.html | 9 +- doc/original_exception_type.html | 7 +- doc/page_idx.html | 8 +- doc/reno.css | 2 + doc/rethrow_exception.html | 9 +- doc/source/boost-exception.reno | 16370 ---------------- doc/source/html_prefix.txt | 21 - doc/source/html_suffix.txt | 18 - doc/synopsis.html | 22 +- doc/throw_exception.html | 12 +- doc/tuple_operator_shl.html | 7 +- doc/tutorial_diagnostic_information.html | 6 +- doc/tutorial_enable_error_info.html | 7 +- doc/tutorial_exception_ptr.html | 6 +- doc/tutorial_transporting_data.html | 7 +- doc/types.html | 7 +- doc/unknown_exception.html | 10 +- ...irtual_inheritance_in_exception_types.html | 7 +- include/boost/exception/all.hpp | 1 + .../exception/errinfo_nested_exception.hpp | 17 + test/Jamfile.v2 | 1 + test/cloning_test.cpp | 5 +- test/errinfo_nested_exception_hpp_test.cpp | 7 + 78 files changed, 249 insertions(+), 16970 deletions(-) create mode 100644 doc/boost_exception_errinfo_nested_exception_hpp.html create mode 100644 doc/errinfo_nested_exception.html delete mode 100644 doc/source/boost-exception.reno delete mode 100644 doc/source/html_prefix.txt delete mode 100644 doc/source/html_suffix.txt create mode 100644 include/boost/exception/errinfo_nested_exception.hpp create mode 100644 test/errinfo_nested_exception_hpp_test.cpp diff --git a/doc/BOOST_THROW_EXCEPTION.html b/doc/BOOST_THROW_EXCEPTION.html index 9647705..89395fb 100644 --- a/doc/BOOST_THROW_EXCEPTION.html +++ b/doc/BOOST_THROW_EXCEPTION.html @@ -35,18 +35,12 @@ #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.

-

See Also:

-
Boost Exception
-boost/throw_exception.hpp
-Frequently Asked Questions
-
+See also: Boost Exception | boost/throw_exception.hpp | Frequently Asked Questions
-

See Also:

-
boost/exception.hpp
-Diagnostic Information
-Integrating Boost Exception in Existing Exception Class Hierarchies
-Synopsis
-
+See also: boost/exception.hpp | Diagnostic Information | Integrating Boost Exception in Existing Exception Class Hierarchies | Synopsis
-

See Also:

-
current_exception_cast
-Synopsis
-
+See also: current_exception_cast | Synopsis
-

See Also:

-
boost/exception/all.hpp
-current_exception_diagnostic_information
-diagnostic_information
-diagnostic_information_what
-Synopsis
-
+See also: boost/exception/all.hpp | current_exception_diagnostic_information | diagnostic_information | diagnostic_information_what | Synopsis
-

See Also:

-
enable_current_exception
-Synopsis
-
+See also: enable_current_exception | Synopsis
-

See Also:

-
enable_error_info
-Synopsis
-
+See also: enable_error_info | Synopsis
-

See Also:

-
boost/exception/all.hpp
-Synopsis
-
+See also: boost/exception/all.hpp | Synopsis
-

See Also:

-
boost/exception/all.hpp
-Synopsis
-
+See also: boost/exception/all.hpp | Synopsis
-

See Also:

-
boost/exception/all.hpp
-Synopsis
-
+See also: boost/exception/all.hpp | Synopsis
-

See Also:

-
boost/exception/all.hpp
-Synopsis
-
+See also: boost/exception/all.hpp | Synopsis
-

See Also:

-
boost/exception/all.hpp
-Synopsis
-
+See also: boost/exception/all.hpp | Synopsis
-

See Also:

-
boost/exception/all.hpp
-Synopsis
-
+See also: boost/exception/all.hpp | Synopsis
-

See Also:

-
boost/exception/all.hpp
-Synopsis
-
+See also: boost/exception/all.hpp | Synopsis
-

See Also:

-
boost/exception/all.hpp
-boost/exception/errinfo_api_function.hpp
-boost/exception/errinfo_at_line.hpp
-boost/exception/errinfo_errno.hpp
-boost/exception/errinfo_file_handle.hpp
-boost/exception/errinfo_file_name.hpp
-boost/exception/errinfo_file_open_mode.hpp
-boost/exception/errinfo_type_info_name.hpp
-error_info
-Synopsis
-
+See also: boost/exception/all.hpp | boost/exception/errinfo_api_function.hpp | boost/exception/errinfo_at_line.hpp | boost/exception/errinfo_errno.hpp | boost/exception/errinfo_file_handle.hpp | boost/exception/errinfo_file_name.hpp | boost/exception/errinfo_file_open_mode.hpp | boost/exception/errinfo_nested_exception.hpp | boost/exception/errinfo_type_info_name.hpp | error_info | Synopsis
-

See Also:

-
BOOST_THROW_EXCEPTION
-boost/exception/all.hpp
-boost/exception/enable_current_exception.hpp
-boost/exception/enable_error_info.hpp
-boost/exception/info.hpp
-boost/exception_ptr.hpp
-exception
-Synopsis
-
+See also: BOOST_THROW_EXCEPTION | boost/exception/all.hpp | boost/exception/enable_current_exception.hpp | boost/exception/enable_error_info.hpp | boost/exception/info.hpp | boost/exception_ptr.hpp | exception | Synopsis
-

See Also:

-
boost/exception/all.hpp
-error_info
-
+See also: boost/exception/all.hpp | error_info
-

See Also:

-
boost/exception/all.hpp
-boost/exception/info_tuple.hpp
-error_info
-error_info::error_info
-error_info::value
-error_info::value_type
-exception/operator<<
-Synopsis
-
+See also: boost/exception/all.hpp | boost/exception/info_tuple.hpp | error_info | error_info::error_info | error_info::value | error_info::value_type | exception/operator<< | Synopsis
-

See Also:

-
boost/exception/all.hpp
-Synopsis
-tuple/operator<<
-
+See also: boost/exception/all.hpp | Synopsis | tuple/operator<<
-

See Also:

-
boost/exception/all.hpp
-copy_exception
-current_exception
-exception_ptr
-original_exception_type
-rethrow_exception
-Synopsis
-unknown_exception
-
+See also: boost/exception/all.hpp | copy_exception | current_exception | exception_ptr | original_exception_type | rethrow_exception | Synopsis | unknown_exception
-

See Also:

-
BOOST_THROW_EXCEPTION
-Configuration Macros
-Synopsis
-throw_exception
-
+See also: BOOST_THROW_EXCEPTION | Configuration Macros | Synopsis | throw_exception
-

See Also:

-
Boost Exception
-get_error_info
-
+See also: Boost Exception | boost/exception/all.hpp | get_error_info
-

See Also:

-
Boost Exception
-boost/exception_ptr.hpp
-
+See also: Boost Exception | boost/exception_ptr.hpp
-

See Also:

-
Boost Exception
-boost/exception_ptr.hpp
-copy_exception
-enable_current_exception
-exception_ptr
-Frequently Asked Questions
-original_exception_type
-unknown_exception
-
+See also: Boost Exception | boost/exception_ptr.hpp | copy_exception | enable_current_exception | exception_ptr | Frequently Asked Questions | original_exception_type | unknown_exception
-

See Also:

-
Boost Exception
-boost/exception/current_exception_cast.hpp
-
+See also: Boost Exception | boost/exception/current_exception_cast.hpp
-

See Also:

-
Boost Exception
-boost/exception/diagnostic_information.hpp
-diagnostic_information
-
+See also: Boost Exception | boost/exception/diagnostic_information.hpp | diagnostic_information
-

See Also:

-
BOOST_THROW_EXCEPTION
-Boost Exception
-boost/exception/diagnostic_information.hpp
-Configuration Macros
-current_exception_diagnostic_information
-Diagnostic Information
-diagnostic_information_what
-Frequently Asked Questions
-Motivation
-throw_exception
-
+See also: BOOST_THROW_EXCEPTION | Boost Exception | boost/exception/diagnostic_information.hpp | Configuration Macros | current_exception_diagnostic_information | Diagnostic Information | diagnostic_information_what | Frequently Asked Questions | Motivation | throw_exception
-

See Also:

-
boost/exception/diagnostic_information.hpp
-
+See also: boost/exception/diagnostic_information.hpp
-

See Also:

-
Boost Exception
-boost/exception/enable_current_exception.hpp
-Configuration Macros
-copy_exception
-current_exception
-Frequently Asked Questions
-Transporting of Exceptions Between Threads
-throw_exception
-
+See also: Boost Exception | boost/exception/enable_current_exception.hpp | Configuration Macros | copy_exception | current_exception | Frequently Asked Questions | Transporting of Exceptions Between Threads | throw_exception
-

See Also:

-
BOOST_THROW_EXCEPTION
-Boost Exception
-boost/exception/enable_error_info.hpp
-Configuration Macros
-Frequently Asked Questions
-Integrating Boost Exception in Existing Exception Class Hierarchies
-throw_exception
-
+See also: BOOST_THROW_EXCEPTION | Boost Exception | boost/exception/enable_error_info.hpp | Configuration Macros | Frequently Asked Questions | Integrating Boost Exception in Existing Exception Class Hierarchies | throw_exception
-

See Also:

-
boost/exception/errinfo_api_function.hpp
-Frequently Asked Questions
-
+See also: boost/exception/errinfo_api_function.hpp | Frequently Asked Questions
-

See Also:

-
boost/exception/errinfo_at_line.hpp
-
+See also: boost/exception/errinfo_at_line.hpp
-

See Also:

-
boost/exception/errinfo_errno.hpp
-Frequently Asked Questions
-
+See also: boost/exception/errinfo_errno.hpp | Frequently Asked Questions
-

See Also:

-
boost/exception/errinfo_file_handle.hpp
-
+See also: boost/exception/errinfo_file_handle.hpp
-

See Also:

-
boost/exception/errinfo_file_name.hpp
-Frequently Asked Questions
-
+See also: boost/exception/errinfo_file_name.hpp | Frequently Asked Questions
-

See Also:

-
boost/exception/errinfo_file_open_mode.hpp
-Frequently Asked Questions
-
+See also: boost/exception/errinfo_file_open_mode.hpp | Frequently Asked Questions

This type is designed to be used as a standard error_info instance for transporting strings returned by std::type_info::name in exceptions deriving from boost::exception objects.

-

See Also:

-
boost/exception/errinfo_type_info_name.hpp
-
+See also: boost/exception/errinfo_type_info_name.hpp
-

See Also:

-
Boost Exception
-boost/exception/error_info.hpp
-boost/exception/exception.hpp
-boost/exception/info.hpp
-diagnostic_information
-diagnostic_information_what
-error_info::error_info
-error_info::value
-error_info::value_type
-exception
-exception/operator<<
-exception_ptr
-Frequently Asked Questions
-get_error_info
-Integrating Boost Exception in Existing Exception Class Hierarchies
-Motivation
-original_exception_type
-tuple/operator<<
-
+See also: Boost Exception | boost/exception/error_info.hpp | boost/exception/exception.hpp | boost/exception/info.hpp | diagnostic_information | diagnostic_information_what | error_info::error_info | error_info::value | error_info::value_type | exception | exception/operator<< | exception_ptr | Frequently Asked Questions | get_error_info | Integrating Boost Exception in Existing Exception Class Hierarchies | Motivation | original_exception_type | tuple/operator<<
-

See Also:

-
error_info
-
+See also: error_info
-

See Also:

-
diagnostic_information
-error_info
-
+See also: diagnostic_information | error_info

Definition:

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

-

See Also:

-
error_info
-error_info::error_info
-error_info::value
-
+See also: error_info | error_info::error_info | error_info::value

See Also:

-
Boost Exception
-boost/exception/diagnostic_information.hpp
-boost/exception/exception.hpp
-Configuration Macros
-current_exception
-current_exception_diagnostic_information
-Diagnostic Information
-diagnostic_information
-diagnostic_information_what
-Exception Types as Simple Semantic Tags
-enable_current_exception
-enable_error_info
-errinfo_api_function
-errinfo_at_line
-errinfo_errno
-errinfo_file_handle
-errinfo_file_name
-errinfo_file_open_mode
-errinfo_type_info_name
-error_info
-exception/operator<<
-exception::exception
-exception::~exception
-exception_ptr
-Frequently Asked Questions
-get_error_info
-Integrating Boost Exception in Existing Exception Class Hierarchies
-Motivation
-Transporting of Arbitrary Data to the Catch Site
-Transporting of Exceptions Between Threads
-tuple/operator<<
-Using Virtual Inheritance in Exception Types
-unknown_exception
-
+
Configuration Macros | current_exception | current_exception_diagnostic_information | Diagnostic Information | diagnostic_information | diagnostic_information_what | enable_current_exception | enable_error_info | error_info | exception_ptr | Frequently Asked Questions | get_error_info | Motivation | Transporting of Arbitrary Data to the Catch Site | Transporting of Exceptions Between Threads | tuple/operator<< | unknown_exception
-

See Also:

-
exception
-
+See also: exception
-

See Also:

-
exception
-
+See also: exception
-

See Also:

-
Boost Exception
-boost/exception/info.hpp
-Diagnostic Information
-diagnostic_information
-error_info
-exception
-exception::exception
-Frequently Asked Questions
-get_error_info
-Integrating Boost Exception in Existing Exception Class Hierarchies
-Motivation
-
+See also: Boost Exception | boost/exception/info.hpp | Diagnostic Information | diagnostic_information | error_info | exception | exception::exception | Frequently Asked Questions | get_error_info | Integrating Boost Exception in Existing Exception Class Hierarchies | Motivation
-

See Also:

-
Boost Exception
-boost/exception_ptr.hpp
-copy_exception
-current_exception
-diagnostic_information
-enable_current_exception
-Frequently Asked Questions
-original_exception_type
-rethrow_exception
-unknown_exception
-
+See also: Boost Exception | boost/exception/errinfo_nested_exception.hpp | boost/exception_ptr.hpp | copy_exception | current_exception | diagnostic_information | enable_current_exception | Frequently Asked Questions | original_exception_type | rethrow_exception | unknown_exception
-

See Also:

-
Boost Exception
-Motivation
-Using Virtual Inheritance in Exception Types
-
+See also: Boost Exception | Motivation | Using Virtual Inheritance in Exception Types
-

See Also:

-
Boost Exception
-Motivation
-
+See also: Boost Exception | Motivation
-

See Also:

-
Boost Exception
-
+See also: Boost Exception
-

See Also:

-
BOOST_THROW_EXCEPTION
-Boost Exception
-boost/exception/get_error_info.hpp
-Configuration Macros
-current_exception
-error_info
-exception
-Motivation
-throw_exception
-
+See also: BOOST_THROW_EXCEPTION | Boost Exception | boost/exception/get_error_info.hpp | Configuration Macros | current_exception | error_info | exception | Motivation | throw_exception
-

See Also:

-
Boost Exception
-
+See also: Boost Exception
-

See Also:

-
Boost Exception
-boost/exception_ptr.hpp
-diagnostic_information
-exception_ptr
-
+See also: Boost Exception | boost/exception_ptr.hpp | diagnostic_information | exception_ptr

#include <boost/exception/errinfo_nested_exception.hpp>

+
#include <boost/exception/error_info.hpp>
+
+namespace
+boost
+    {
+    typedef ---unspecified--- exception_ptr;
+    typedef error_info<struct errinfo_nested_exception_,exception_ptr> errinfo_nested_exception;
+    }

#include <boost/exception/errinfo_type_info_name.hpp>

#include <boost/exception/error_info.hpp>
 #include <string>
@@ -243,25 +252,24 @@ boost
 #include <boost/exception/get_error_info.hpp>
 #include <boost/exception/info.hpp>
 #include <boost/exception/info_tuple.hpp>
-#include <boost/exception_ptr.hpp>
 #include <boost/exception/errinfo_api_function.hpp>
 #include <boost/exception/errinfo_at_line.hpp>
 #include <boost/exception/errinfo_errno.hpp>
 #include <boost/exception/errinfo_file_handle.hpp>
 #include <boost/exception/errinfo_file_name.hpp>
 #include <boost/exception/errinfo_file_open_mode.hpp>
-#include <boost/exception/errinfo_type_info_name.hpp>
+#include <boost/exception/errinfo_type_info_name.hpp> +#ifndef BOOST_NO_EXCEPTIONS +#include <boost/exception/errinfo_nested_exception.hpp> +#include <boost/exception_ptr.hpp> +#endif
-

See Also:

-
Boost Exception
-
+See also: Boost Exception
-

See Also:

-
BOOST_THROW_EXCEPTION
-Boost Exception
-boost/throw_exception.hpp
-Configuration Macros
-enable_current_exception
-Frequently Asked Questions
-Transporting of Exceptions Between Threads
-
+See also: BOOST_THROW_EXCEPTION | Boost Exception | boost/throw_exception.hpp | Configuration Macros | enable_current_exception | Frequently Asked Questions | Transporting of Exceptions Between Threads
-

See Also:

-
Boost Exception
-boost/exception/info_tuple.hpp
-
+See also: Boost Exception | boost/exception/info_tuple.hpp
-

See Also:

-
Boost Exception
-
+See also: Boost Exception
-

See Also:

-
Boost Exception
-Motivation
-
+See also: Boost Exception | Motivation

Regardless, the use of current_exception and rethrow_exception in the above examples is well-formed.

-

See Also:

-
Boost Exception
-
+See also: Boost Exception
-

See Also:

-
Boost Exception
-Integrating Boost Exception in Existing Exception Class Hierarchies
-
+See also: Boost Exception | Integrating Boost Exception in Existing Exception Class Hierarchies
-

See Also:

-
Boost Exception
-
+See also: Boost Exception

This type is used by the exception_ptr support in Boost Exception. Please see current_exception.

-

See Also:

-
Boost Exception
-boost/exception_ptr.hpp
-current_exception
-enable_current_exception
-original_exception_type
-
+See also: Boost Exception | boost/exception_ptr.hpp | current_exception | enable_current_exception | original_exception_type
-

See Also:

-
Boost Exception
-Frequently Asked Questions
-
+See also: Boost Exception | Frequently Asked Questions