2008-06-28 18:29:40 +00:00
< !DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN'
'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
< html xmlns = 'http://www.w3.org/1999/xhtml' xml:lang = 'en' lang = 'en' >
< head >
< meta http-equiv = 'Content-Type' content = 'text/html; charset=utf-8' / >
< title > enable_current_exception< / title >
< link href = 'reno.css' type = 'text/css' rel = 'stylesheet' / >
< / head >
< body >
< div class = "body-0" >
< div class = "body-1" >
< div class = "body-2" >
< div >
< div id = "boost_logo" >
< a href = "http://www.boost.org" > < img style = "border:0" src = "http://www.boost.org/boost.png" alt = "Boost" width = "277" height = "86" / > < / a >
< / div >
< h1 > Boost Exception< / h1 >
< / div >
2009-04-02 05:04:38 +00:00
<!-- Copyright (c) 2006 - 2009 Emil Dotchevski and Reverge Studios, Inc. -->
2008-06-28 18:29:40 +00:00
<!-- Distributed under the Boost Software License, Version 1.0. (See accompanying -->
<!-- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -->
2008-07-09 00:39:00 +00:00
< div class = "RenoIncludeDIV" > < div class = "RenoAutoDIV" > < h3 > enable_current_exception< / h3 >
< / div >
2008-09-19 20:29:26 +00:00
< div class = "RenoIncludeDIV" > < p > < span class = "RenoEscape" > # <!-- <wiki>`#</wiki> --> < / span > include < < span class = "RenoLink" > < a href = "exception_enable_current_exception_hpp.html" > boost/exception/enable_current_exception.hpp< / a > < / span > > < / p >
2008-06-28 18:29:40 +00:00
< pre > namespace
boost
{
< span class = "RenoIncludeSPAN" > template < class T>
2009-04-08 20:09:47 +00:00
---unspecified--- < span class = "RenoLink" > enable_current_exception< / span > ( T const & e );< / span >
2008-06-28 18:29:40 +00:00
}< / pre >
< / div > < h4 > Requirements:< / h4 >
2008-09-19 20:29:26 +00:00
< p > T must be a class with an accessible no-throw copy constructor.< / p >
2008-06-28 18:29:40 +00:00
< h4 > Returns:< / h4 >
< p > An object of < i > unspecified< / i > type which derives publicly from T. That is, the returned object can be intercepted by a catch(T & ).< / p >
< h4 > Description:< / h4 >
2008-07-09 00:39:00 +00:00
< p > This function is designed to be used directly in a throw-expression to enable the < span class = "RenoLink" > < a href = "exception_ptr.html" > exception_ptr< / a > < / span > support in Boost Exception. For example:< / p >
2008-06-28 18:29:40 +00:00
< pre > class
my_exception:
public std::exception
{
};
....
2009-04-08 20:09:47 +00:00
throw boost::< span class = "RenoLink" > enable_current_exception< / span > (my_exception());< / pre >
< p > Unless < span class = "RenoLink" > enable_current_exception< / span > is called at the time an exception object is used in a throw-expression, an attempt to copy it using < span class = "RenoLink" > < a href = "current_exception.html" > current_exception< / a > < / span > may return an < span class = "RenoLink" > < a href = "exception_ptr.html" > exception_ptr< / a > < / span > which refers to an instance of < span class = "RenoLink" > < a href = "unknown_exception.html" > unknown_exception< / a > < / span > . See < span class = "RenoLink" > < a href = "current_exception.html" > current_exception< / a > < / span > for details.< / p >
2008-06-28 18:29:40 +00:00
< h4 > Note:< / h4 >
2008-07-09 00:39:00 +00:00
< p > Instead of using the throw keyword directly, it is preferable to call boost::< span class = "RenoLink" > < a href = "throw_exception.html" > throw_exception< / a > < / span > . This is guaranteed to throw an exception that derives from boost::< span class = "RenoLink" > < a href = "exception.html" > exception< / a > < / span > and supports the < span class = "RenoLink" > < a href = "exception_ptr.html" > exception_ptr< / a > < / span > functionality.< / p >
< / div > < div class = "RenoAutoDIV" > < div class = "RenoHR" > < hr / > < / div >
< h3 > See Also:< / h3 >
2008-06-28 18:29:40 +00:00
< div class = "RenoPageList" > < a href = "boost-exception.html" > Boost Exception< br / >
2008-09-19 20:29:26 +00:00
< / a > < a href = "exception_enable_current_exception_hpp.html" > boost/exception/enable_current_exception.hpp< br / >
< / a > < a href = "configuration_macros.html" > Configuration Macros< br / >
< / a > < a href = "copy_exception.html" > copy_exception< br / >
2008-06-28 18:29:40 +00:00
< / a > < a href = "current_exception.html" > current_exception< br / >
2009-04-01 21:30:25 +00:00
< / a > < a href = "frequently_asked_questions.html" > Frequently Asked Questions< br / >
2008-07-16 21:03:14 +00:00
< / a > < a href = "tutorial_exception_ptr.html" > Transporting of Exceptions Between Threads< br / >
2008-06-28 18:29:40 +00:00
< / a > < a href = "throw_exception.html" > throw_exception< br / >
< / a > < / div >
2008-07-09 00:39:00 +00:00
< / div >
2009-04-02 05:04:38 +00:00
<!-- Copyright (c) 2006 - 2009 Emil Dotchevski and Reverge Studios, Inc. -->
2008-06-28 18:29:40 +00:00
<!-- Distributed under the Boost Software License, Version 1.0. (See accompanying -->
<!-- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -->
< div id = "footer" >
< p > < / p >
< hr / >
< p >
2009-03-29 05:04:54 +00:00
< a class = "logo" href = "http://jigsaw.w3.org/css-validator/check/referer" > < img class = "logo_pic" src = "valid-css.png" alt = "Valid CSS" height = "31" width = "88" / > < / a >
2008-06-28 18:29:40 +00:00
< a class = "logo" href = "http://validator.w3.org/check?uri=referer" > < img class = "logo_pic" src = "valid-xhtml.png" alt = "Valid XHTML 1.0" height = "31" width = "88" / > < / a >
2009-04-02 05:04:38 +00:00
< small > Copyright (c) 2006-2009 by Emil Dotchevski and Reverge Studios, Inc.< br / >
2008-06-28 18:29:40 +00:00
Distributed under the < a href = "http://www.boost.org/LICENSE_1_0.txt" > Boost Software License, Version 1.0< / a > .< / small >
< / p >
< / div >
< / div >
< / div >
< / div >
< / body >
< / html >
