From 073f5bbd032d5a38d4b6422be93455ffd076ef58 Mon Sep 17 00:00:00 2001 From: bkoz Date: Wed, 9 Feb 2011 01:45:25 +0000 Subject: 2011-02-08 Benjamin Kosnik * doc/html/*: Regenerate. git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@169960 138bc75d-0d04-0410-961f-82ee72b054a4 --- libstdc++-v3/doc/html/manual/using_exceptions.html | 99 +++++++++------------- 1 file changed, 39 insertions(+), 60 deletions(-) (limited to 'libstdc++-v3/doc/html/manual/using_exceptions.html') diff --git a/libstdc++-v3/doc/html/manual/using_exceptions.html b/libstdc++-v3/doc/html/manual/using_exceptions.html index 925d732cffd..0cdc2b4f56b 100644 --- a/libstdc++-v3/doc/html/manual/using_exceptions.html +++ b/libstdc++-v3/doc/html/manual/using_exceptions.html @@ -1,6 +1,6 @@ - -Exceptions
Exceptions
Prev Chapter 3. Using Next

Exceptions

+ +Exceptions

Exceptions
Prev Chapter 3. Using Next

The C++ language provides language support for stack unwinding with try and catch blocks and the throw keyword. @@ -12,7 +12,7 @@ exceptional circumstances.

Two general topics of discussion follow: exception neutrality and exception safety. -

Exception Safety

+

What is exception-safe code?

Will define this as reasonable and well-defined behavior by classes @@ -27,7 +27,7 @@ exception neutrality and exception safety. Using the layered approach from Abrahams, can classify library components as providing set levels of safety. These will be called exception guarantees, and can be divided into three categories. -

Exception Neutrality

+

Simply put, once thrown an exception object should continue in flight unless handled explicitly. In practice, this means propagating exceptions should not be swallowed in @@ -75,7 +75,7 @@ exception neutrality and exception safety. Unfortunately, this tends to be more of a guideline than a strict rule as applied to the standard library. As such, the following is a list of known problem areas where exceptions are not propagated. -

Doing without

+

C++ is a language that strives to be as efficient as is possible in delivering features. As such, considerable care is used by both language implementer and designers to make sure unused features @@ -113,7 +113,7 @@ exception neutrality and exception safety. support try and catch blocks and thrown objects. (Language support for -fno-exceptions is documented in the GNU - GCC manual.) + GCC manual.)

Before detailing the library support for -fno-exceptions, first a passing note on the things lost when this flag is used: it will break exceptions @@ -220,7 +220,7 @@ exception neutrality and exception safety. substitution of the C language keyword const with the uglified doppelganger __const. -

Compatibility

With C

+

C language code that is expecting to interoperate with C++ should be compiled with -fexceptions. This will make debugging a C language function called as part of C++-induced stack @@ -235,7 +235,7 @@ is called. getting these details right. For GNU systems, all appropriate parts of the GNU C library are already compiled with -fexceptions. -

With POSIX thread cancellation

+

GNU systems re-use some of the exception handling mechanisms to track control flow for POSIX thread cancellation.

@@ -266,63 +266,42 @@ is called. } catch(...) { this->_M_setstate(ios_base::badbit); } -

Bibliography

- - - System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008) - - - . +

+ . + System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008) + . 2.9.5 Thread Cancellation . Copyright © 2008 The Open Group/The Institute of Electrical and Electronics Engineers, Inc. - .

- - - Error and Exception Handling - - - . David Abrahams . + .

+ . + Error and Exception Handling + . David Abrahams . Boost - .

- - - Exception-Safety in Generic Components - - - . David Abrahams. + .

+ . + Exception-Safety in Generic Components + . David Abrahams. Boost - .

- - - Standard Library Exception Policy - - - . Matt Austern. + .

+ . + Standard Library Exception Policy + . Matt Austern. WG21 N1077 - .

- - - ia64 c++ abi exception handling - - - . Richard Henderson. + .

+ . + ia64 c++ abi exception handling + . Richard Henderson. GNU - .

- - - Appendix E: Standard-Library Exception Safety - - - . Bjarne Stroustrup.

+ .

+ . + Appendix E: Standard-Library Exception Safety + . Bjarne Stroustrup.

Exceptional C++ - . + . Exception-Safety Issues and Techniques - . Herb Sutter.

- - - GCC Bug 25191: exception_defines.h #defines try/catch - - - .

Prev Up Next
Concurrency Home Debugging Support
+ . Herb Sutter.

+ . + GCC Bug 25191: exception_defines.h #defines try/catch + .

Prev Up Next
Concurrency Home Debugging Support
-- cgit v1.2.3