[boost-doc-zh commit] r264 - for Version 1.39

From: codesite-noreply@xxxxxxxxxx
To: boost-doc-zh-notify@xxxxxxxxxxxxx
Date: Mon, 15 Jun 2009 01:18:18 +0000

Author: zhaohongchao
Date: Sun Jun 14 17:49:43 2009
New Revision: 264

Modified:
   trunk/libs/exception/doc/BOOST_THROW_EXCEPTION.html
   trunk/libs/exception/doc/boost-exception.html
   trunk/libs/exception/doc/boost_exception_current_exception_cast_hpp.html
   trunk/libs/exception/doc/configuration_macros.html
   trunk/libs/exception/doc/copy_exception.html
   trunk/libs/exception/doc/current_exception.html
   trunk/libs/exception/doc/current_exception_cast.html
   trunk/libs/exception/doc/current_exception_diagnostic_information.html
   trunk/libs/exception/doc/diagnostic_information.html
   trunk/libs/exception/doc/enable_current_exception.html
   trunk/libs/exception/doc/enable_error_info.html
   trunk/libs/exception/doc/error_info.html
   trunk/libs/exception/doc/error_info_error_info.html
   trunk/libs/exception/doc/error_info_value.html
   trunk/libs/exception/doc/error_info_value_type.html
   trunk/libs/exception/doc/exception.html
   trunk/libs/exception/doc/exception_cloning_hpp.html
   trunk/libs/exception/doc/exception_constructors.html
   trunk/libs/exception/doc/exception_destructor.html
   trunk/libs/exception/doc/exception_diagnostic_information_hpp.html
   trunk/libs/exception/doc/exception_enable_current_exception_hpp.html
   trunk/libs/exception/doc/exception_enable_error_info_hpp.html
   trunk/libs/exception/doc/exception_error_info_group_hpp.html
   trunk/libs/exception/doc/exception_error_info_hpp.html
   trunk/libs/exception/doc/exception_error_info_value_hpp.html
   trunk/libs/exception/doc/exception_exception_hpp.html
   trunk/libs/exception/doc/exception_get_error_info_hpp.html
   trunk/libs/exception/doc/exception_hpp.html
   trunk/libs/exception/doc/exception_operator_shl.html
   trunk/libs/exception/doc/exception_ptr.html
   trunk/libs/exception/doc/exception_types_as_simple_semantic_tags.html
   trunk/libs/exception/doc/frequently_asked_questions.html
   trunk/libs/exception/doc/functions.html
   trunk/libs/exception/doc/get_error_info.html
   trunk/libs/exception/doc/headers.html
   trunk/libs/exception/doc/macros.html
   trunk/libs/exception/doc/motivation.html
   trunk/libs/exception/doc/page_idx.html
   trunk/libs/exception/doc/rethrow_exception.html
   trunk/libs/exception/doc/synopsis.html
   trunk/libs/exception/doc/throw_exception.html
   trunk/libs/exception/doc/throw_exception_hpp.html
   trunk/libs/exception/doc/tuple_operator_shl.html
   trunk/libs/exception/doc/tutorial_diagnostic_information.html
   trunk/libs/exception/doc/tutorial_enable_error_info.html
   trunk/libs/exception/doc/tutorial_exception_ptr.html
   trunk/libs/exception/doc/tutorial_transporting_data.html
   trunk/libs/exception/doc/types.html
   trunk/libs/exception/doc/unknown_exception.html

trunk/libs/exception/doc/using_virtual_inheritance_in_exception_types.html


Log:
for Version 1.39

Modified: trunk/libs/exception/doc/BOOST_THROW_EXCEPTION.html
==============================================================================
--- trunk/libs/exception/doc/BOOST_THROW_EXCEPTION.html (original)

+++ trunk/libs/exception/doc/BOOST_THROW_EXCEPTION.html Sun Jun 14 17:49:432009

@@ -33,9 +33,9 @@
 #else

#define <spanclass="RenoLink">BOOST_THROW_EXCEPTION(x) ::boost::<spanclass="RenoLink"><ahref="throw_exception.html">throw_exception</a>(x)

 #endif</pre>

-</div></div>This macro takes an exception object, recordsBOOST_CURRENT_FUNCTION, __FILE__ and __LINE__ in it, and forwards it to<ahref="throw_exception.html">throw_exception</a>. To recover thisinformation at the catch site, use <ahref="get_error_info.html">get_error_info</a>; the information isalso included in the message returned by <ahref="diagnostic_information.html">diagnostic_information</a>.+</div></div>这个宏以一个异常对象为参数，记录了当前的函数信息BOOST_CURRENT_FUNCTION, 文件信息__FILE__ 和行号信息 __LINE__ , 并且把它们传递给函数 <ahref="throw_exception.html">throw_exception</a>. 为了在catch端恢复这些数据, 可以使用函数 <ahref="get_error_info.html">get_error_info</a>; 这些信息也包含在通过函数 <ahref="diagnostic_information.html">diagnostic_information</a>得到的返回消息中.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="throw_exception_hpp.html">boost/throw_exception.hpp<br/>

</a><a href="frequently_asked_questions.html">Frequently AskedQuestions 


Modified: trunk/libs/exception/doc/boost-exception.html
==============================================================================
--- trunk/libs/exception/doc/boost-exception.html       (original)
+++ trunk/libs/exception/doc/boost-exception.html       Sun Jun 14 17:49:43 2009
@@ -19,34 +19,34 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

-<div class="RenoIncludeDIV"><h2>Introduction</h2>

-The purpose of Boost Exception is to ease the design of exception classhierarchies and to help write exception handling and error reportingcode.-It supports transporting of arbitrary data to the catch site, which isotherwise tricky due to the no-throw requirements (15.5.1) for exceptiontypes. Data can be added to any exception object, either directly in thethrow-expression (15.1), or at a later time as the exception objectpropagates up the call stack.-The ability to add data to exception objects after they have beenpassed to throw is important, because often some of the information neededto handle an exception is unavailable in the context where the failure isdetected. -Boost Exception also supports <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2179.html";>N2179</a>-style<ahref="tutorial_exception_ptr.html">copying</a> of exception objects,implemented non-intrusively and automatically by the boost::<spanclass="RenoLink"><a href="throw_exception.html">throw_exception</a>function.

-<h2>Contents</h2>

-<div><ol><li><ahref="motivation.html">Motivation</a></li>-<li>Tutorial<div><ol><li><ahref="tutorial_transporting_data.html">Transporting of Arbitrary Data tothe Catch Site</a></li>-<li><ahref="tutorial_enable_error_info.html">Integrating Boost Exception inExisting Exception Class Hierarchies</a></li>-<li><ahref="tutorial_exception_ptr.html">Transporting of Exceptions BetweenThreads</a></li>-<li><ahref="exception_types_as_simple_semantic_tags.html">Exception Types asSimple Semantic Tags</a></li>-<li><ahref="using_virtual_inheritance_in_exception_types.html">Using VirtualInheritance in Exception Types</a></li>-<li><ahref="tutorial_diagnostic_information.html">DiagnosticInformation</a></li>

+<div class="RenoIncludeDIV"><h2>介绍</h2>

+Boost Exception 的目的是为了简化层次化异常类的设计, 并帮助编写异常处理和错误报告的代码.+Boost Exception支持向catch端任意数据的传递, 这一点因为标准(15.5.1)对异常类型的无异常抛出保证而显得有点诡异(译者注,参见C++标准15.5.1对terminate()函数调用的第一个解释:当要抛出的异常对象被评估之后,被捕获之前,一个用户的函数被执行并抛出未捕获的异常.标准还给出了一个例子解释:当一个被抛出的异常对象的拷贝构造函数抛出异常的时候.这个解释和例子真是够诡异的).无论是直接在throw语句之内,或者在以后当异常对象传播到调用堆栈某个地方的时候, 都可以对异常对象添加任何数据.+异常对象被抛出以后仍然可以被添加数据的能力是很重要的, 因为经常时在某些时候错误被侦测到, 但是异常处理的某些信息却得不到. +Boost Exception 还支持 <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2179.html";>N2179</a>-风格的异常对象的 <ahref="tutorial_exception_ptr.html">拷贝</a> , 这是通过函数boost::<ahref="throw_exception.html">throw_exception</a> 以一种非入侵和自动的方式实现的.

+<h2>内容</h2>

+<div><ol><li><a href="motivation.html">动机</a></li>+<li>简介<div><ol><li><ahref="tutorial_transporting_data.html">向catch端传递任意的数据</a></li>+<li><a href="tutorial_enable_error_info.html">BoostException和已有的异常类体系的集成</a></li>+<li><a href="tutorial_exception_ptr.html">线程之间传递异常</a></li>+<li><ahref="exception_types_as_simple_semantic_tags.html">作为简单语义标记的异常类型</a></li>+<li><ahref="using_virtual_inheritance_in_exception_types.html">在异常类型之间使用虚拟继承</a></li>+<li><ahref="tutorial_diagnostic_information.html">调试信息</a></li>

 </ol></div>
 </li>

-<li>Documentation<div><ol><li>Class <ahref="exception.html">exception</a></li>-<li>Throwing Exceptions<div><ol><li><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION</a></li>+<li>文档<div><ol><li>类 <ahref="exception.html">exception</a></li>+<li>异常抛出<div><ol><li><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION</a></li><li><ahref="throw_exception.html">throw_exception</a></li>

 </ol></div>
 </li>

-<li>Transporting of Arbitrary Data to the Catch Site<div><ol><li><spanclass="RenoLink"><a href="error_info.html">error_info</a></li>+<li>向catch端传递任意的数据<div><ol><li><ahref="error_info.html">error_info</a></li><li><ahref="exception_operator_shl.html">exception/operator<<</a></li><li><ahref="tuple_operator_shl.html">tuple/operator<<</a></li><li><ahref="get_error_info.html">get_error_info</a></li><li><ahref="enable_error_info.html">enable_error_info</a></li>

 </ol></div>
 </li>

-<li><ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2179.html";>N2179</a>Transporting of Exceptions between Threads<div><ol><li><spanclass="RenoLink"><a href="exception_ptr.html">exception_ptr</a></li>+<li><ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2179.html";>N2179</a>在线程之间传递异常<div><ol><li><ahref="exception_ptr.html">exception_ptr</a></li><li><ahref="enable_current_exception.html">enable_current_exception</a></li><li><ahref="current_exception.html">current_exception</a></li><li><ahref="copy_exception.html">copy_exception</a></li>

@@ -54,26 +54,26 @@

<li><ahref="unknown_exception.html">unknown_exception</a></li>

 </ol></div>
 </li>

-<li>Diagnostic Information<div><ol><li><ahref="diagnostic_information.html">diagnostic_information</a></li>+<li>调试信息<div><ol><li><ahref="diagnostic_information.html">diagnostic_information</a></li><li><ahref="current_exception_diagnostic_information.html">current_exception_diagnostic_information</a></li>

 </ol></div>
 </li>

<li><ahref="current_exception_cast.html">current_exception_cast</a></li>

 </ol></div>
 </li>

-<li>API<div><ol><li><ahref="synopsis.html">Synopsis</a></li>

-<li><span class="RenoLink"><a href="headers.html">Headers</a></span></li>
-<li><span class="RenoLink"><a href="types.html">Types</a></span></li>

-<li><ahref="functions.html">Functions</a></li>

-<li><span class="RenoLink"><a href="macros.html">Macros</a></span></li>

-<li><ahref="configuration_macros.html">Configuration Macros</a></li>+<li>API<div><ol><li><a href="synopsis.html">概要</a></li>

+<li><span class="RenoLink"><a href="headers.html">头文件</a></span></li>
+<li><span class="RenoLink"><a href="types.html">类型</a></span></li>
+<li><span class="RenoLink"><a href="functions.html">函数</a></span></li>
+<li><span class="RenoLink"><a href="macros.html">宏</a></span></li>

+<li><a href="configuration_macros.html">配置宏</a></li>

 </ol></div>
 </li>

-<li><ahref="frequently_asked_questions.html">Frequently AskedQuestions</a></li>-<li><a href="page_idx.html">PageIndex</a></li>+<li><ahref="frequently_asked_questions.html">FAQ</a></li>

+<li><span class="RenoLink"><a href="page_idx.html">页索引</a></span></li>
 </ol></div>
-<h3>Acknowledgements</h3>

-Thanks to Peter Dimov for his continuing help. Also thanks to TobiasSchwinger, Tom Brinkman, Pavel Vozenilek and everyone who participated inthe review process.

+<h3>致谢</h3>

+感谢 Peter Dimov 持续不断的帮助. 同时感谢 Tobias Schwinger, TomBrinkman, Pavel Vozenilek 和每个参与审阅过程的人.</div>

Modified:trunk/libs/exception/doc/boost_exception_current_exception_cast_hpp.html

==============================================================================

---trunk/libs/exception/doc/boost_exception_current_exception_cast_hpp.html(original)+++trunk/libs/exception/doc/boost_exception_current_exception_cast_hpp.htmlSun Jun 14 17:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception/current_exception_cast.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>
 <div class="RenoIncludeDIV"><pre>namespace
 boost
     {
@@ -29,7 +29,7 @@

E * <ahref="current_exception_cast.html">current_exception_cast</a>();

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="current_exception_cast.html">current_exception_cast 

 </a><a href="synopsis.html">Synopsis<br/>
 </a></div>

Modified: trunk/libs/exception/doc/configuration_macros.html
==============================================================================
--- trunk/libs/exception/doc/configuration_macros.html  (original)

+++ trunk/libs/exception/doc/configuration_macros.html Sun Jun 14 17:49:432009

@@ -3,7 +3,7 @@
 <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>configuration macros</title>
+       <title>配置宏</title>
        <link href='reno.css' type='text/css' rel='stylesheet'/>
 </head>
 <body>
@@ -19,21 +19,21 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

+<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>配置宏</h2>
 </div>
-<p>Boost Exception responds to the following configuration macros:</p>
+<p>Boost Exception 依赖于以下的配置宏:</p>

BOOST_NO_RTTI<spanclass="RenoBR">  BOOST_NO_TYPEID-The first macro prevents Boost Exception from using dynamic_cast anddynamic typeid. If the second macro is also defined, Boost Exception doesnot use static typeid either. There are no observable degrading effects onthe library functionality, except for the following:-<blockquote>By default, the <ahref="get_error_info.html">get_error_info</a> function template canbe called with any exception type. If BOOST_NO_RTTI is defined, <spanclass="RenoLink"><a href="get_error_info.html">get_error_info</a>can be used only with objects of type boost::<ahref="exception.html">exception</a>.</blockquote>

-<h4>Note:</h4>

-The library needs RTTI functionality. Disabling the language RTTIsupport enables an internal RTTI system, which may have more or lessoverhead depending on the platform.+第一个宏禁止 Boost Exception 使用 dynamic_cast 和动态的 typeid. 如果第二个宏也定义了，Boost Exception 也不会使用静态的 typeid. 这些对函数库的功能没有显著的影响, 除了以下所述:+<blockquote>默认情况下, 模板函数 <ahref="get_error_info.html">get_error_info</a> 可用于任何的异常类型.如果定义了 BOOST_NO_RTTI , 函数模版<ahref="get_error_info.html">get_error_info</a> 只能用于 boost::<spanclass="RenoLink"><a href="exception.html">exception</a>类型.</blockquote>

+<h4>注意:</h4>

+本函数库需要 RTTI 功能. 禁止语言对 RTTI 的支持,会导致一个内部实现的RTTI 系统, 这依赖于不同的平台,代价不一.

 <p><b>BOOST_EXCEPTION_DISABLE</b></p>

-By default, <ahref="enable_current_exception.html">enable_current_exception</a>and <ahref="enable_error_info.html">enable_error_info</a> are integrateddirectly in the <ahref="throw_exception.html">throw_exception</a> function. DefiningBOOST_EXCEPTION_DISABLE disables this integration.-Note that on some non-conformant compilers, for example MSVC 7.0 andolder, as well as BCC, BOOST_EXCEPTION_DISABLE is implicitly defined in<ahref="throw_exception_hpp.html">boost/throw_exception.hpp</a>.+默认情况下, <ahref="enable_current_exception.html">enable_current_exception</a> 和<ahref="enable_error_info.html">enable_error_info</a> 直接和函数 <spanclass="RenoLink"><a href="throw_exception.html">throw_exception</a>集成在一起. 定义宏 BOOST_EXCEPTION_DISABLE 会禁止这种集成.+注意在某些非标准的编译器上,例如 MSVC 7.0 或者更早的版本, 以及 BCC, 宏BOOST_EXCEPTION_DISABLE 是在头文件 <ahref="throw_exception_hpp.html">boost/throw_exception.hpp</a>中默认定义的.

 <p><b>BOOST_NO_EXCEPTIONS</b></p>

-This macro disables exception handling in Boost, forwarding allexceptions to a user-defined non-template version of boost::<spanclass="RenoLink"><a href="throw_exception.html">throw_exception</a>.However, unless BOOST_EXCEPTION_DISABLE is also defined, users can stillexamine the exception object for any data added at the point of the throw,or use boost::<ahref="diagnostic_information.html">diagnostic_information</a> (ofcourse under BOOST_NO_EXCEPTIONS, the user-defined boost::throw_exceptionis not allowed to return to the caller.)+这个宏将禁止Boost的异常机制, 导致所有的异常调用去执行一个用户定义的非模版函数 boost::<ahref="throw_exception.html">throw_exception</a>. 然而, 除非宏BOOST_EXCEPTION_DISABLE 也被定义, 否则用户在异常抛出点仍然可以使用添加在异常对象上的任何数据, 或者使用相关函数 boost::<ahref="diagnostic_information.html">diagnostic_information</a> (当然,如果定义了 BOOST_NO_EXCEPTIONS, 用户定义的函数 boost::throw_exception 不允许返回给调用者.)

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="get_error_info.html">get_error_info<br/>
 </a></div>

Modified: trunk/libs/exception/doc/copy_exception.html
==============================================================================
--- trunk/libs/exception/doc/copy_exception.html        (original)
+++ trunk/libs/exception/doc/copy_exception.html        Sun Jun 14 17:49:43 2009
@@ -28,8 +28,8 @@
 <span class="RenoIncludeSPAN">    template &lt;class T&gt;

<ahref="exception_ptr.html">exception_ptr</a> <spanclass="RenoLink">copy_exception( T const & e );

     }</pre>
-</div><h4>Effects:</h4>
-<p>As if</p>
+</div><h4>效果:</h4>
+<p>如下</p>
 <pre>try
     {

throw <ahref="enable_current_exception.html">enable_current_exception</a>(e);

@@ -39,7 +39,7 @@

return <ahref="current_exception.html">current_exception</a>();

     }</pre>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="exception_cloning_hpp.html">boost/exception_ptr.hpp<br/>
 </a></div>

Modified: trunk/libs/exception/doc/current_exception.html
==============================================================================
--- trunk/libs/exception/doc/current_exception.html     (original)
+++ trunk/libs/exception/doc/current_exception.html     Sun Jun 14 17:49:43 2009
@@ -27,20 +27,29 @@
     {

 <ahref="exception_ptr.html">exception_ptr</a> <spanclass="RenoLink">current_exception();

     }</pre>
-</div><h4>Requirements:</h4>

-The current_exception function must notbe called outside of a catch block.

-<h4>Returns:</h4>

-<div><ul><li> An <ahref="exception_ptr.html">exception_ptr</a> that refers to thecurrently handled exception or a copy of the currently handledexception.</li>-<li> If the function needs to allocate memory and the attempt fails, itreturns an <ahref="exception_ptr.html">exception_ptr</a> that refers to aninstance of std::bad_alloc.</li>

+</div><h4>要求:</h4>

+在catch块的外部不能在调用函数 <spanclass="RenoLink">current_exception.

+<h4>返回值:</h4>

+<div><ul><li> 异常对象指针 <ahref="exception_ptr.html">exception_ptr</a> ,指向当前处理的异常对象或者其拷贝.</li>+<li> 如果函数需要分配内存,但是分配失败, <ahref="exception_ptr.html">exception_ptr</a>

+    对象指向一个 std::bad_alloc 的实例.</li>
 </ul></div>
-<h4>Throws:</h4>
-<p>Nothing.</p>
-<h4>Notes:</h4>

-<div><ul><li> It is unspecified whether the return values of twosuccessive calls to current_exception referto the same exception object.</li>-<li> Correct implementation of <spanclass="RenoLink">current_exception may require compiler support,unless <ahref="enable_current_exception.html">enable_current_exception</a>was used at the time the currently handled exception object was passed tothrow. If <ahref="enable_current_exception.html">enable_current_exception</a>was not used, and if the compiler does not provide the necessary support,then current_exception may return an <spanclass="RenoLink"><a href="exception_ptr.html">exception_ptr</a> thatrefers to an instance of <ahref="unknown_exception.html">unknown_exception</a>. In this case,if the original exception object derives from boost::<spanclass="RenoLink"><a href="exception.html">exception</a>, then theboost::<a href="exception.html">exception</a>sub-object of the <ahref="unknown_exception.html">unknown_exception</a> object isinitialized by the boost::<ahref="exception.html">exception</a> copy constructor.</li>

+<h4>异常抛出:</h4>
+<p>没有异常.</p>
+<h4>注意:</h4>

+<div><ul><li> 连续两次的调用函数 <ahref="current_exception.html">current_exception</a>

+    ,并不保证得到的总是同一的异常对象.</li>

+<li> 在需要抛出当前要处理的异常的时候,除非调用了函数<spanclass="RenoLink"><ahref="enable_current_exception.html">enable_current_exception</a>,+ 否则函数 <ahref="current_exception.html">current_exception</a>+ 的实现可能需要编译器的支持. 如果没有调用函数 <ahref="enable_current_exception.html">enable_current_exception</a> ,+ 并且编译器没有提供必要的支持,那么函数 <ahref="current_exception.html">current_exception</a>+ 可能返回一个指向<ahref="unknown_exception.html">unknown_exception</a>类型的异常对象指针.+ 在这种情况下, 如果初始的异常对象是从 boost::<ahref="exception.html">exception</a>继承而来,+ 那么通过boost::<ahref="exception.html">exception</a> 的copy构造函数, <spanclass="RenoLink"><ahref="unknown_exception.html">unknown_exception</a>

+    类型的子对象就会被构造出来.</li>
 </ul></div>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="exception_cloning_hpp.html">boost/exception_ptr.hpp<br/>
 </a><a href="copy_exception.html">copy_exception<br/>

Modified: trunk/libs/exception/doc/current_exception_cast.html
==============================================================================
--- trunk/libs/exception/doc/current_exception_cast.html        (original)

+++ trunk/libs/exception/doc/current_exception_cast.html Sun Jun 1417:49:43 2009

@@ -28,14 +28,14 @@
 <span class="RenoIncludeSPAN">    template &lt;class E&gt;
     E * <span class="RenoLink">current_exception_cast</span>();</span>
     }</pre>
-</div><h4>Requirements:</h4>
-<p>This function must not be called outside of a catch block.</p>
-<h4>Returns:</h4>

-A pointer of type E to the current exception object, or null if thecurrent exception object can not be converted to E *.

-<h4>Throws:</h4>
-<p>Nothing.</p>
+</div><h4>要求:</h4>
+<p>这个函数不能在catch块的外部调用.</p>
+<h4>返回值:</h4>

+一个指向当前异常对象的E*类指针; 如果当前的异常对象不能转化为E*对象类型,那么返回null.

+<h4>异常抛出:</h4>
+<p>没有异常.</p>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><ahref="boost_exception_current_exception_cast_hpp.html">boost/exception/current_exception_cast.hpp 

 </a></div>

Modified:trunk/libs/exception/doc/current_exception_diagnostic_information.html

==============================================================================

--- trunk/libs/exception/doc/current_exception_diagnostic_information.html(original)+++ trunk/libs/exception/doc/current_exception_diagnostic_information.htmlSun Jun 14 17:49:43 2009

@@ -27,11 +27,11 @@
     {

 std::string <spanclass="RenoLink">current_exception_diagnostic_information();

     }</pre>
-</div><h4>Requirements:</h4>
-<p>This function must not be called outside of a catch block.</p>
-<h4>Returns:</h4>

-If the current exception object can be converted to boost::<spanclass="RenoLink"><a href="exception.html">exception</a> orstd::exception, this function returns the same string value returned by<ahref="diagnostic_information.html">diagnostic_information</a> forthe current exception object. Otherwise, an unspecified non-empty string isreturned.-Typical use is to call <spanclass="RenoLink">current_exception_diagnostic_information from atop-level function to output diagnostic information about unhandledexceptions:

+</div><h4>要求:</h4>
+<p>这个函数不能在catch块的外部调用.</p>
+<h4>返回值:</h4>

+如果当前的异常对象能够转化为 boost::<ahref="exception.html">exception</a> 或者 std::exception 类型, 这个函数的返回信息和函数 <ahref="diagnostic_information.html">diagnostic_information</a> 对当前异常对象的返回信息时一致的. 否则, 返回一个不确定的非空字符串.+调用函数 <spanclass="RenoLink">current_exception_diagnostic_information 的典型情况是在顶端函数输出未处理的异常的调试信息:

 <pre>int
 main()
     {
@@ -52,7 +52,7 @@
         }
     }</pre>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><ahref="exception_diagnostic_information_hpp.html">boost/exception/diagnostic_information.hpp 

 </a></div>

Modified: trunk/libs/exception/doc/diagnostic_information.html
==============================================================================
--- trunk/libs/exception/doc/diagnostic_information.html        (original)

+++ trunk/libs/exception/doc/diagnostic_information.html Sun Jun 1417:49:43 2009

@@ -28,28 +28,28 @@
 <span class="RenoIncludeSPAN">    template &lt;class E&gt;

std::string diagnostic_information( Econst & e );

     }</pre>
-</div><h4>Returns:</h4>

-A string value that contains varying amount of implementation-specificdiagnostic information about the passed exception object:-<div><ul><li>If E can be statically converted to boost::<spanclass="RenoLink"><a href="exception.html">exception</a>, thereturned value contains the string representations of all <spanclass="RenoLink"><a href="error_info.html">error_info</a> objectsstored in the boost::<ahref="exception.html">exception</a> through <spanclass="RenoLink"><ahref="exception_operator_shl.html">operator<<</a>, along withother diagnostic information relevant to the exception. If e can bedynamically converted to std::exception, the returned value also containsthe what() string.</li>-<li>Otherwise, if E can be statically convertedstd::exception:<div><ul><li>if e can be dynamically converted toboost::exception, the returned value is the same as if E could bestatically converted to boost::<ahref="exception.html">exception</a>;</li>

-<li>otherwise the returned value contains the what() string.</li>
+</div><h4>返回值:</h4>
+<p>一个字符串数值, 包含了实现端指定的,关于传入异常对象的各种调试信息:</p>

+<div><ul><li>如果 E 可以被静态的转换为 boost::<ahref="exception.html">exception</a> 类型, 返回值包含了通过<spanclass="RenoLink"><ahref="exception_operator_shl.html">operator<<</a>存贮在boost::<ahref="exception.html">exception</a>对象中所有<spanclass="RenoLink"><a href="error_info.html">error_info</a>类型的对象信息, 同时还包含异常对象的调试信息. 如果 e 是 std::exception 类型, 返回值还包含 what() 信息.</li>+<li>否则, 如果 E 能够静态转换为 std::exception:<div><ul><li>如果 e 可以动态转换为 boost::exception, 返回值和E能够静态转换为 boost::<spanclass="RenoLink"><a href="exception.html">exception</a>类型的返回值是一样的;</li>

+<li>否则,返回值包含 what() 信息.</li>
 </ul></div>
 </li>

-<li>Otherwise, the boost::<spanclass="RenoLink">diagnostic_information template is notavailable.</li>+<li>否则, 函数模板 boost::<spanclass="RenoLink">diagnostic_information 不可用.</li>

 </ul></div>

-The string representation of each <ahref="error_info.html">error_info</a> object is deduced by afunction call that is bound at the time the <ahref="error_info.html">error_info</a><Tag,T> template isinstantiated. The following overload resolutions are attempted in order:-<div><ol><li>Unqualified call to to_string(x), where x is of type <spanclass="RenoLink"><ahref="error_info.html">error_info</a><Tag,T> (the return valueis expected to be of type std::string.)</li>-<li>Unqualified call to to_string(x.<ahref="error_info_value.html">value</a>()) (the return value isexpected to be of type std::string.)</li>-<li>Unqualified call to s << x.<ahref="error_info_value.html">value</a>(), where s is astd::ostringstream.</li>+每个 <ahref="error_info.html">error_info</a> 对象的字符串表现是通过函数推导出来的,函数绑定时间发生在模板 <ahref="error_info.html">error_info</a><Tag,T> 实例化的时候. 以下的重载决议会依次执行:+<div><ol><li>执行函数 to_string(x), x 是 <ahref="error_info.html">error_info</a><Tag,T> 类型的( 期望返回值能够转换为 std::string 类型.)</li>+<li>执行函数 to_string(x.<ahref="error_info_value.html">value</a>()) (期望返回值能够转换为std::string 类型.)</li>+<li>执行函数 s << x.<ahref="error_info_value.html">value</a>(), s 是 std::ostringstream 类型的对象.</li>

 </ol></div>

-The first successfully bound function is used at the time <spanclass="RenoLink">diagnostic_information is called; if all 3 overloadresolutions are unsuccessful, the system is unable to convert the <spanclass="RenoLink"><a href="error_info.html">error_info</a> object tostring, and an unspecified stub string value is used without issuing acompile error.

-<h4>Notes:</h4>
-<div><ul><li>The format of the returned string is unspecified.</li>
-<li>The returned string is <i>not</i> user-friendly.</li>

-<li>The returned string may include additional platform-specificdiagnostic information.</li>+第一个成功绑定的函数会在函数 <spanclass="RenoLink">diagnostic_information 被调用的是偶执行; 如果三个重载决议都没有成功, 那么系统就不能成功转换 <ahref="error_info.html">error_info</a> 对象为字符串信息, 那么 一个未定义的存根字符串会被使用, 不会产生任何的编译错误.

+<h4>注意:</h4>
+<div><ul><li>字符串的个格式是未定义的.</li>
+<li>返回的字符串并 <i>不是</i> 用户友好的.</li>
+<li>返回的字符串可能包含平台相关的信息.</li>
 </ul></div>
 <div class="RenoIncludeDIV"><h4>Example:</h4>

-this is a possible output from the <spanclass="RenoLink">diagnostic_information function, as used inlibs/exception/example/example_io.cpp:+以下是函数 diagnostic_information 可能产生的输出之一, 这是在文件 libs/exception/example/example_io.cpp:中使用的<pre>example_io.cpp(83): Throw in function classboost::shared_ptr<struct _iobuf> __cdecl my_fopen(const char *,constchar *)Dynamic exception type: class boost::exception_detail::clone_impl<classfopen_error>

 std::exception::what: example_io error
@@ -58,7 +58,7 @@
 [struct tag_function *] = fopen
 [struct tag_open_mode *] = rb</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION 

 </a><a href="boost-exception.html">Boost Exception<br/>

</a><ahref="exception_diagnostic_information_hpp.html">boost/exception/diagnostic_information.hpp 


Modified: trunk/libs/exception/doc/enable_current_exception.html
==============================================================================
--- trunk/libs/exception/doc/enable_current_exception.html      (original)

+++ trunk/libs/exception/doc/enable_current_exception.html Sun Jun 1417:49:43 2009

@@ -28,12 +28,12 @@
 <span class="RenoIncludeSPAN">    template &lt;class T&gt;

---unspecified--- <spanclass="RenoLink">enable_current_exception( T const & e );

     }</pre>
-</div><h4>Requirements:</h4>
-<p>T must be a class with an accessible no-throw copy constructor.</p>
-<h4>Returns:</h4>

-An object of unspecified type which derives publicly from T.That is, the returned object can be intercepted by a catch(T &).

-<h4>Description:</h4>

-This function is designed to be used directly in a throw-expression toenable the <ahref="exception_ptr.html">exception_ptr</a> support in BoostException. For example:

+</div><h4>要求:</h4>
+<p>T 的copy构造函数不能抛出异常,并且是可访问.</p>
+<h4>返回值:</h4>

+是从T继承的不确定类型. 也就是说, 可以通过语句 catch(T &) 截获异常.

+<h4>描述:</h4>

+这个函数可以直接使用在throw语句中,从而使得<ahref="exception_ptr.html">exception_ptr</a>支持 Boost 异常. 例如:

 <pre>class
 my_exception:
     public std::exception
@@ -42,11 +42,11 @@

 ....

throw boost::<spanclass="RenoLink">enable_current_exception(my_exception());</pre>-Unless enable_current_exception is calledat the time an exception object is used in a throw-expression, an attemptto copy it using <ahref="current_exception.html">current_exception</a> may return an<ahref="exception_ptr.html">exception_ptr</a> which refers to aninstance of <ahref="unknown_exception.html">unknown_exception</a>. See <spanclass="RenoLink"><ahref="current_exception.html">current_exception</a> for details.

-<h4>Note:</h4>

-Instead of using the throw keyword directly, it is preferable to callboost::<ahref="throw_exception.html">throw_exception</a>. This is guaranteedto throw an exception that derives from boost::<ahref="exception.html">exception</a> and supports the <spanclass="RenoLink"><a href="exception_ptr.html">exception_ptr</a>functionality.+除非在抛出异常的语句中调用了 <ahref="enable_current_exception.html">enable_current_exception</a> ,否则异常对象的拷贝会使得函数 <ahref="current_exception.html">current_exception</a> 的返回值指向一个<ahref="unknown_exception.html">unknown_exception</a>类型的对象. 更详细的信息参见 <ahref="current_exception.html">current_exception</a> .

+<h4>注意:</h4>

+相对于直接使用throw关键字, 更好的方式是调用 boost::<spanclass="RenoLink"><a href="throw_exception.html">throw_exception</a>.这个函数确保抛出的异常对象继承自 boost::<ahref="exception.html">exception</a> , 从而也支持 <spanclass="RenoLink"><a href="exception_ptr.html">exception_ptr</a> 的功能.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><ahref="exception_enable_current_exception_hpp.html">boost/exception/enable_current_exception.hpp 

 </a><a href="configuration_macros.html">Configuration Macros<br/>

Modified: trunk/libs/exception/doc/enable_error_info.html
==============================================================================
--- trunk/libs/exception/doc/enable_error_info.html     (original)
+++ trunk/libs/exception/doc/enable_error_info.html     Sun Jun 14 17:49:43 2009
@@ -28,16 +28,18 @@
 <span class="RenoIncludeSPAN">    template &lt;class T&gt;

---unspecified--- enable_error_info( Tconst & x );

     }</pre>
-</div><h4>Requirements:</h4>

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

-<h4>Returns:</h4>

-<div><ul><li> If T derives from boost::<ahref="exception.html">exception</a>, the returned object is of typeT and is a copy of x.</li>-<li> Otherwise, the returned object is of an unspecified type that derivespublicly from both T and boost::<ahref="exception.html">exception</a>. The T sub-object is initializedfrom x by the T copy constructor.</li>

+</div><h4>要求:</h4>
+<p>T 的copy构造函数不能抛出异常,并且是可访问.参见(15.5.1).</p>
+<h4>返回值:</h4>

+<div><ul><li> 如果T继承自 boost::<ahref="exception.html">exception</a>,

+    那么返回的对象是x的一个拷贝.</li>

+<li> 否则, 返回的对象类型不确定,但是确保共有继承自 T 和 boost::<spanclass="RenoLink"><a href="exception.html">exception</a>.

+    T类型的子对象通过T的构造函数初始化.</li>
 </ul></div>
-<h4>Throws:</h4>
-<p>Nothing.</p>
+<h4>异常抛出:</h4>
+<p>没有异常.</p>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION 

 </a><a href="boost-exception.html">Boost Exception<br/>

</a><ahref="exception_enable_error_info_hpp.html">boost/exception/enable_error_info.hpp 


Modified: trunk/libs/exception/doc/error_info.html
==============================================================================
--- trunk/libs/exception/doc/error_info.html    (original)
+++ trunk/libs/exception/doc/error_info.html    Sun Jun 14 17:49:43 2009
@@ -37,30 +37,30 @@

 <ahref="error_info_value_type.html">value_type</a> const & <spanclass="RenoLink"><a href="error_info_value.html">value</a>()const;

         };</span>
     }</pre>
-</div><h4>Requirements:</h4>

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

-<h4>Description:</h4>

-This class template is used to associate a Tag type with a value typeT. Objects of type error_info<Tag,T>can be passed to <ahref="exception_operator_shl.html">operator<<</a> to be storedin objects of type boost::<ahref="exception.html">exception</a>.

-<h4>Usage:</h4>

-The header <<ahref="exception_error_info_value_hpp.html">boost/exception/error_info.hpp</a>>provides a declaration of the error_infotemplate, which is sufficient for the purpose of typedefing an instance forspecific Tag and T, for example:

+</div><h4>要求:</h4>

+T 的拷贝构造函数必须是可访问的, 并且不能是引用(T的拷贝构造是否抛出异常不是必须的).

+<h4>描述:</h4>

+这个模板类的目的是把一个Tag类型和一个T类型的变量结合在一起.  <spanclass="RenoLink"><ahref="error_info.html">error_info</a><Tag,T> 类型的对象可以传递给流式操作符 <ahref="operator_shl_exception.html">operator<<</a> ,从而把值存储在 boost::<a href="exception.html">exception</a> 对象里面.

+<h4>使用方法:</h4>

+头文件 <<ahref="exception_error_info_value_hpp.html">boost/exception/error_info.hpp</a>>提供了模板类 <ahref="error_info.html">error_info</a> 的声明, 这对于提供基于Tag和T的类型别名声明是足够的,如下:<pre>#include <<ahref="exception_error_info_value_hpp.html">boost/exception/error_info.hpp</a>>


 struct tag_errno;

typedef boost::<spanclass="RenoLink">error_info<tag_errno,int> errno_info;</pre>

-<p>Or, the shorter equivalent:</p>
+<p>或者,更加简练一些:</p>

<pre>#include <<ahref="exception_error_info_value_hpp.html">boost/exception/error_info.hpp</a>>

typedef boost::error_info<structtag_errno,int> errno_info;</pre>-This errno_info typedef can be passed to <ahref="exception_operator_shl.html">operator<<</a> (#include<<ahref="exception_error_info_hpp.html">boost/exception/info.hpp</a>>first) to store an int named tag_errno in exceptions of types that derivefrom boost::<ahref="exception.html">exception</a>:+errno_info 类型对象可以传递给流式操作符 <ahref="exception_operator_shl.html">operator<<</a> (#include<<ahref="exception_error_info_hpp.html">boost/exception/info.hpp</a>>first) ,把命名为 tag_errno 的整型变量存储在从 boost::<spanclass="RenoLink"><a href="exception.html">exception</a>继承的对象里面:<pre>throw file_read_error() <ahref="exception_operator_shl.html"><<</a>errno_info(errno);</pre>-It can also be passed to <ahref="get_error_info.html">get_error_info</a> (#include <<spanclass="RenoLink"><ahref="exception_get_error_info_hpp.html">boost/exception/get_error_info.hpp</a>>first) to retrieve the tag_errno int from a boost::<spanclass="RenoLink"><a href="exception.html">exception</a>:+它也可以传递给函数 <ahref="get_error_info.html">get_error_info</a> (#include <<spanclass="RenoLink"><ahref="exception_get_error_info_hpp.html">boost/exception/get_error_info.hpp</a>>first) ,从 boost::<ahref="exception.html">exception</a> 对象抽取tag_errno数值:<pre>catch( boost::<ahref="exception.html">exception</a> & x )

if( int const * e=boost::<ahref="get_error_info.html">get_error_info</a><errno_info>(x) )

         ....
     }</pre>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><ahref="exception_error_info_value_hpp.html">boost/exception/error_info.hpp </a><ahref="exception_exception_hpp.html">boost/exception/exception.hpp 


Modified: trunk/libs/exception/doc/error_info_error_info.html
==============================================================================
--- trunk/libs/exception/doc/error_info_error_info.html (original)

+++ trunk/libs/exception/doc/error_info_error_info.html Sun Jun 14 17:49:432009

@@ -23,12 +23,12 @@
 </div>

<div class="RenoIncludeDIV"><spanclass="RenoEscape">#include <<spanclass="RenoLink"><ahref="exception_error_info_hpp.html">boost/exception/info.hpp</a>><pre><spanclass="RenoLink">error_info( <ahref="error_info_value_type.html">value_type</a> const & v);</pre>

-</div><h4>Effects:</h4>

-Stores a copy of v in the <ahref="error_info.html">error_info</a> object.

-<div class="RenoIncludeDIV"><h4>Throws:</h4>
-<p>Any exception emitted by v's copy constructor.</p>
+</div><h4>效果:</h4>

+在类型 <ahref="error_info.html">error_info</a> 对象中存储v值的拷贝.

+<div class="RenoIncludeDIV"><h4>异常抛出:</h4>
+<p>由 v 的拷贝构造函数引发的任何异常对象.</p>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>
 <div class="RenoPageList"><a href="error_info.html">error_info<br/>
 </a></div>
 </div>

Modified: trunk/libs/exception/doc/error_info_value.html
==============================================================================
--- trunk/libs/exception/doc/error_info_value.html      (original)
+++ trunk/libs/exception/doc/error_info_value.html      Sun Jun 14 17:49:43 2009
@@ -23,12 +23,12 @@
 </div>

<div class="RenoIncludeDIV"><spanclass="RenoEscape">#include <<spanclass="RenoLink"><ahref="exception_error_info_hpp.html">boost/exception/info.hpp</a>><pre><ahref="error_info_value_type.html">value_type</a> const & <spanclass="RenoLink">value() const;</pre>

-</div><h4>Description:</h4>

-Returns a const reference to the copy of the value passed to <spanclass="RenoLink"><a href="error_info.html">error_info</a>'sconstructor stored in the <ahref="error_info.html">error_info</a> object.

-<h4>Throws:</h4>
-<p>Nothing.</p>
+</div><h4>描述:</h4>

+返回一个存储在 <ahref="error_info.html">error_info</a> 对象中的常量引用, 这个数值是在<a href="error_info.html">error_info</a> 对象构造函数中引进的.

+<h4>异常抛出:</h4>
+<p>没有异常.</p>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="diagnostic_information.html">diagnostic_information 

 </a><a href="error_info.html">error_info<br/>
 </a></div>

Modified: trunk/libs/exception/doc/error_info_value_type.html
==============================================================================
--- trunk/libs/exception/doc/error_info_value_type.html (original)

+++ trunk/libs/exception/doc/error_info_value_type.html Sun Jun 14 17:49:432009

@@ -24,9 +24,9 @@

<div class="RenoIncludeDIV"><spanclass="RenoEscape">#include <<spanclass="RenoLink"><ahref="exception_error_info_hpp.html">boost/exception/info.hpp</a>><pre>typedef T <spanclass="RenoLink">value_type;</pre>

 </div><h4>Definition:</h4>

-The expression <ahref="error_info.html">error_info</a><Tag,T>::<spanclass="RenoLink">value_type evaluates to T.+表达式 <ahref="error_info.html">error_info</a><Tag,T>::<spanclass="RenoLink">value_type 等同于 T.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>
 <div class="RenoPageList"><a href="error_info.html">error_info<br/>
 </a><a href="error_info_error_info.html">error_info::error_info<br/>
 </a><a href="error_info_value.html">error_info::value<br/>

Modified: trunk/libs/exception/doc/exception.html
==============================================================================
--- trunk/libs/exception/doc/exception.html     (original)
+++ trunk/libs/exception/doc/exception.html     Sun Jun 14 17:49:43 2009
@@ -35,11 +35,11 @@

 <ahref="exception_destructor.html">~exception</a>();

         };</span>
     }</pre>

-</div>Class boost::exception is designedto be used as a universal base for user-defined exception types.-An object of any type deriving from boost::<spanclass="RenoLink">exception can store data of arbitrary types, usingthe <a href="error_info.html">error_info</a>wrapper and <ahref="exception_operator_shl.html">operator<<</a>.-To retrieve data from a boost::exceptionobject, use the <ahref="get_error_info.html">get_error_info</a> function template.+</div> boost::<ahref="exception.html">exception</a>类被设计为用户自定义异常类型的基类.+通过 <ahref="error_info.html">error_info</a> 包裹器和<spanclass="RenoLink">流式操作符<ahref="exception_operator_shl.html">operator<<</a>, 从boost::<a href="exception.html">exception</a>继承的异常类可以存储任何类型的数据.+要从 boost::<ahref="exception.html">exception</a> 对象获取数据, 使用模板函数 <spanclass="RenoLink"><a href="get_error_info.html">get_error_info</a>

 </div><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><ahref="exception_diagnostic_information_hpp.html">boost/exception/diagnostic_information.hpp </a><ahref="exception_exception_hpp.html">boost/exception/exception.hpp 


Modified: trunk/libs/exception/doc/exception_cloning_hpp.html
==============================================================================
--- trunk/libs/exception/doc/exception_cloning_hpp.html (original)

+++ trunk/libs/exception/doc/exception_cloning_hpp.html Sun Jun 14 17:49:432009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception_ptr.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>

<div class="RenoIncludeDIV"><pre>#include <<ahref="exception_exception_hpp.html">boost/exception/exception.hpp</a>>


 namespace
@@ -45,7 +45,7 @@

void <ahref="rethrow_exception.html">rethrow_exception</a>( <spanclass="RenoLink"><a href="exception_ptr.html">exception_ptr</a>const & ep );

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="exception_hpp.html">boost/exception.hpp 

 </a><a href="copy_exception.html">copy_exception<br/>
 </a><a href="current_exception.html">current_exception<br/>

Modified: trunk/libs/exception/doc/exception_constructors.html
==============================================================================
--- trunk/libs/exception/doc/exception_constructors.html        (original)

+++ trunk/libs/exception/doc/exception_constructors.html Sun Jun 1417:49:43 2009

@@ -23,14 +23,14 @@
 </div>
 <div class="RenoIncludeDIV"><pre><span class="RenoLink">exception</span>();

exception( <ahref="exception.html">exception</a> const & x );</pre>

-</div><h4>Effects:</h4>

-<div><ul><li> Default constructor: initializes an empty boost::<spanclass="RenoLink"><a href="exception.html">exception</a> object.</li>-<li> Copy constructor: initializes a boost::<ahref="exception.html">exception</a> object which shares ownershipwith x of all data added through <ahref="exception_operator_shl.html">operator<<</a>, includingdata that is added at a future time.</li>

+</div><h4>效果:</h4>

+<div><ul><li> 默认构造器,初始化一个空的 boost::<ahref="exception.html">exception</a> 对象.</li>+<li> 拷贝构造器,初始化一个 boost::<ahref="exception.html">exception</a> 对象,共享x的所有数据,包括通过流式操作符<ahref="exception_operator_shl.html">operator<<</a> 添加的数据,以及以后添加的数据.</li>

 </ul></div>
-<h4>Throws:</h4>
-<p>Nothing.</p>
+<h4>异常抛出:</h4>
+<p>没有异常.</p>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>
 <div class="RenoPageList"><a href="exception.html">exception<br/>
 </a></div>
 </div>

Modified: trunk/libs/exception/doc/exception_destructor.html
==============================================================================
--- trunk/libs/exception/doc/exception_destructor.html  (original)

+++ trunk/libs/exception/doc/exception_destructor.html Sun Jun 14 17:49:432009

@@ -22,12 +22,12 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h3>exception::~exception</h3>

 </div>

<div class="RenoIncludeDIV"><pre><spanclass="RenoLink">~exception();</pre>

-</div><h4>Effects:</h4>

-Frees all resources associated with a boost::<ahref="exception.html">exception</a> object.

-<h4>Throws:</h4>
-<p>Nothing.</p>
+</div><h4>效果:</h4>

+释放所有和 boost::<ahref="exception.html">exception</a> 对象关联的资源.

+<h4>异常抛出:</h4>
+<p>没有异常.</p>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>
 <div class="RenoPageList"><a href="exception.html">exception<br/>
 </a></div>
 </div>

Modified: trunk/libs/exception/doc/exception_diagnostic_information_hpp.html
==============================================================================

--- trunk/libs/exception/doc/exception_diagnostic_information_hpp.html(original)+++ trunk/libs/exception/doc/exception_diagnostic_information_hpp.html SunJun 14 17:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception/diagnostic_information.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>
 <div class="RenoIncludeDIV"><pre>#include &lt;string&gt;

 namespace
@@ -35,7 +35,7 @@

std::string <ahref="current_exception_diagnostic_information.html">current_exception_diagnostic_information</a>();

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="exception_hpp.html">boost/exception.hpp </a><ahref="current_exception_diagnostic_information.html">current_exception_diagnostic_information 

 </a><a href="diagnostic_information.html">diagnostic_information<br/>

Modified:trunk/libs/exception/doc/exception_enable_current_exception_hpp.html

==============================================================================

--- trunk/libs/exception/doc/exception_enable_current_exception_hpp.html(original)+++ trunk/libs/exception/doc/exception_enable_current_exception_hpp.htmlSun Jun 14 17:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h3>boost/exception/enable_current_exception.hpp</h3>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>

<div class="RenoIncludeDIV"><pre>#include <<ahref="exception_exception_hpp.html">boost/exception/exception.hpp</a>>


 namespace
@@ -31,7 +31,7 @@

---unspecified--- <ahref="enable_current_exception.html">enable_current_exception</a>( Tconst & e );

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="enable_current_exception.html">enable_current_exception 

 </a><a href="synopsis.html">Synopsis<br/>
 </a></div>

Modified: trunk/libs/exception/doc/exception_enable_error_info_hpp.html
==============================================================================
--- trunk/libs/exception/doc/exception_enable_error_info_hpp.html       
(original)

+++ trunk/libs/exception/doc/exception_enable_error_info_hpp.html Sun Jun14 17:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h3>boost/exception/enable_error_info.hpp</h3>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>

<div class="RenoIncludeDIV"><pre>#include <<ahref="exception_exception_hpp.html">boost/exception/exception.hpp</a>>


 namespace
@@ -31,7 +31,7 @@

---unspecified--- <ahref="enable_error_info.html">enable_error_info</a>( T const & x);

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="enable_error_info.html">enable_error_info 

 </a><a href="synopsis.html">Synopsis<br/>
 </a></div>

Modified: trunk/libs/exception/doc/exception_error_info_group_hpp.html
==============================================================================
--- trunk/libs/exception/doc/exception_error_info_group_hpp.html        
(original)

+++ trunk/libs/exception/doc/exception_error_info_group_hpp.html Sun Jun 1417:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception/info_tuple.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>

<div class="RenoIncludeDIV"><pre>#include <<ahref="exception_error_info_hpp.html">boost/exception/info.hpp</a>>

 #include &lt;boost/tuple/tuple.hpp&gt;

@@ -36,7 +36,7 @@

<ahref="error_info.html">error_info</a><TagN,TN> > const& v );

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="exception_hpp.html">boost/exception.hpp 

 </a><a href="synopsis.html">Synopsis<br/>
 </a><a href="tuple_operator_shl.html">tuple/operator&lt;&lt;<br/>

Modified: trunk/libs/exception/doc/exception_error_info_hpp.html
==============================================================================
--- trunk/libs/exception/doc/exception_error_info_hpp.html      (original)

+++ trunk/libs/exception/doc/exception_error_info_hpp.html Sun Jun 1417:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception/info.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>

<div class="RenoIncludeDIV"><pre>#include <<ahref="exception_exception_hpp.html">boost/exception/exception.hpp</a>>


 namespace
@@ -43,7 +43,7 @@

E const & <ahref="exception_operator_shl.html">operator<<</a>( E const& x, <ahref="error_info.html">error_info</a><Tag,T> const & v);

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="exception_hpp.html">boost/exception.hpp </a><ahref="exception_error_info_group_hpp.html">boost/exception/info_tuple.hpp 

 </a><a href="error_info.html">error_info<br/>

Modified: trunk/libs/exception/doc/exception_error_info_value_hpp.html
==============================================================================
--- trunk/libs/exception/doc/exception_error_info_value_hpp.html        
(original)

+++ trunk/libs/exception/doc/exception_error_info_value_hpp.html Sun Jun 1417:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception/error_info.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>
 <div class="RenoIncludeDIV"><pre>namespace
 boost
     {
@@ -29,7 +29,7 @@

class <ahref="error_info.html">error_info</a>;

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="exception_hpp.html">boost/exception.hpp 

 </a><a href="error_info.html">error_info<br/>
 </a><a href="synopsis.html">Synopsis<br/>

Modified: trunk/libs/exception/doc/exception_exception_hpp.html
==============================================================================
--- trunk/libs/exception/doc/exception_exception_hpp.html       (original)

+++ trunk/libs/exception/doc/exception_exception_hpp.html Sun Jun 1417:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception/exception.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>
 <div class="RenoIncludeDIV"><pre>namespace
 boost
     {
@@ -43,7 +43,7 @@

typedef <ahref="error_info.html">error_info</a><structtag_throw_line,int> throw_line;

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION 

 </a><a href="exception_hpp.html">boost/exception.hpp<br/>

</a><ahref="exception_enable_current_exception_hpp.html">boost/exception/enable_current_exception.hpp 


Modified: trunk/libs/exception/doc/exception_get_error_info_hpp.html
==============================================================================
--- trunk/libs/exception/doc/exception_get_error_info_hpp.html  (original)

+++ trunk/libs/exception/doc/exception_get_error_info_hpp.html Sun Jun 1417:49:43 2009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception/get_error_info.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>
 <div class="RenoIncludeDIV"><pre>#include &lt;boost/shared_ptr.hpp&gt;

 namespace
@@ -31,7 +31,7 @@

typename ErrorInfo::<ahref="error_info_value_type.html">value_type</a> const * <spanclass="RenoLink"><a href="get_error_info.html">get_error_info</a>( Econst & x );

     }</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="exception_hpp.html">boost/exception.hpp 

 </a><a href="error_info.html">error_info<br/>
 </a></div>

Modified: trunk/libs/exception/doc/exception_hpp.html
==============================================================================
--- trunk/libs/exception/doc/exception_hpp.html (original)
+++ trunk/libs/exception/doc/exception_hpp.html Sun Jun 14 17:49:43 2009
@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/exception.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>

<div class="RenoIncludeDIV"><pre>#include<<ahref="exception_diagnostic_information_hpp.html">boost/exception/diagnostic_information.hpp</a>>#include <<ahref="exception_error_info_value_hpp.html">boost/exception/error_info.hpp</a>>#include <<ahref="exception_exception_hpp.html">boost/exception/exception.hpp</a>>

@@ -30,7 +30,7 @@

#include <<ahref="exception_error_info_group_hpp.html">boost/exception/info_tuple.hpp</a>>#include <<ahref="exception_cloning_hpp.html">boost/exception_ptr.hpp</a>></pre>

 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="tutorial_diagnostic_information.html">Diagnostic Information </a><a href="tutorial_enable_error_info.html">Integrating Boost Exceptionin Existing Exception Class Hierarchies 

 </a><a href="synopsis.html">Synopsis<br/>

Modified: trunk/libs/exception/doc/exception_operator_shl.html
==============================================================================
--- trunk/libs/exception/doc/exception_operator_shl.html        (original)

+++ trunk/libs/exception/doc/exception_operator_shl.html Sun Jun 1417:49:43 2009

@@ -28,16 +28,16 @@

 template <class E, class Tag, classT>E const & operator<<( E const& x, <ahref="error_info.html">error_info</a><Tag,T> const & v);

     }</pre>
-</div><h4>Requirements:</h4>

-E must be boost::<ahref="exception.html">exception</a>, or a type that derives(indirectly) from boost::<ahref="exception.html">exception</a>.

-<h4>Effects:</h4>

-Stores a copy of v into x. If x already contains data of type <spanclass="RenoLink"><ahref="error_info.html">error_info</a><Tag,T>, that data isoverwritten.

-<h4>Returns:</h4>
+</div><h4>要求:</h4>

+E 必须是 boost::<ahref="exception.html">exception</a> 类型, 或者是从 boost::<spanclass="RenoLink"><a href="exception.html">exception</a>继承的类型.

+<h4>效果:</h4>

+把v的拷贝存储在x对象中. 如果已经存在这种 <ahref="error_info.html">error_info</a><Tag,T> 类型的数据, 原来的数据就被覆盖.

+<h4>返回值:</h4>
 <p>x.</p>
-<div class="RenoIncludeDIV"><h4>Throws:</h4>
-<p>std::bad_alloc, or any exception emitted by the T copy constructor.</p>
+<div class="RenoIncludeDIV"><h4>异常抛出:</h4>
+<p>std::bad_alloc, 或者通过T的拷贝构造函数抛出的任何异常.</p>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="exception_error_info_hpp.html">boost/exception/info.hpp<br/>

</a><a href="tutorial_diagnostic_information.html">DiagnosticInformation 


Modified: trunk/libs/exception/doc/exception_ptr.html
==============================================================================
--- trunk/libs/exception/doc/exception_ptr.html (original)
+++ trunk/libs/exception/doc/exception_ptr.html Sun Jun 14 17:49:43 2009
@@ -27,16 +27,16 @@
     {

 typedef ---unspecified--- <spanclass="RenoLink">exception_ptr;

     }</pre>

-</div>The exception_ptr type can be usedto refer to a copy of an exception object. It is Default Constructible,Copy Constructible, Assignable and Equality Comparable; <spanclass="RenoLink">exception_ptr's operations do not throw.-Two instances of exception_ptr areequivalent and compare equal if and only if they refer to the sameexception.-The default constructor of exception_ptrproduces the null value of the type. The null value is equivalent only toitself.

-<h4>Thread safety</h4>

-<div><ul><li> It is legal for multiple threads to hold <spanclass="RenoLink">exception_ptr references to the same exceptionobject.</li>-<li> It is illegal for multiple threads to modify the same <spanclass="RenoLink">exception_ptr object concurrently.</li>-<li> While calling <ahref="current_exception.html">current_exception</a> makes a copy ofthe current exception object, it is still possible for the two copies toshare internal state. Therefore, in general it is not safe to call <spanclass="RenoLink"><ahref="rethrow_exception.html">rethrow_exception</a> concurrently tothrow the same exception object into multiple threads.</li>+</div>exception_ptr类型用来指向异常对象的拷贝. 它符合 Default Constructible, Copy Constructible, Assignable 和Equality Comparable 概念的要求; exception_ptr类型的操作不抛出异常.+两个 exception_ptr 类型的实例被认为是相等的,当且仅当它们指向同一个异常对.+exception_ptr 的默认构造函数初始化一个null 值的对象, 并且只是和自身相等.

+<h4>线程安全</h4>

+<div><ul><li> 多个线程可以合法的拥有多个 <spanclass="RenoLink">exception_ptr 类型的实例, 它们指向同一个异常对象.</li>+<li> 多个线程可以并发的修改同一个 <spanclass="RenoLink">exception_ptr 类型的对象.</li>+<li> 调用函数 <ahref="current_exception.html">current_exception</a> 会产生当前异常对象的拷贝, 两个拷贝可能共享同一的内部状态. 因此在并发环境中,通过函数 <spanclass="RenoLink"><ahref="rethrow_exception.html">rethrow_exception</a> 向多个线程重新抛出异常并不安全.</li>

 </ul></div>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="exception_cloning_hpp.html">boost/exception_ptr.hpp<br/>
 </a><a href="copy_exception.html">copy_exception<br/>

Modified:trunk/libs/exception/doc/exception_types_as_simple_semantic_tags.html

==============================================================================

--- trunk/libs/exception/doc/exception_types_as_simple_semantic_tags.html(original)+++ trunk/libs/exception/doc/exception_types_as_simple_semantic_tags.htmlSun Jun 14 17:49:43 2009

@@ -21,16 +21,16 @@

<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>Exception Typesas Simple Semantic Tags</h3>

 </div>

-Deriving from boost::<ahref="exception.html">exception</a> effectively decouples thesemantics of a failure from the information that is relevant to eachindividual instance of reporting a failure with a given semantic.-In other words: with boost::<ahref="exception.html">exception</a>, what data a given exceptionobject transports depends primarily on the context in which failures arereported (not on its type.) Since exception types need no members, itbecomes very natural to throw exceptions that derive from more than onetype to indicate multiple appropriate semantics:+从 boost::<ahref="exception.html">exception</a> 继承异常类型, 可以高效的对多个语义解耦, 使得单个异常类型只是报告一种给定的错误语义.+换句话说: 使用 boost::<ahref="exception.html">exception</a>, 给定异常对象所传递的信息基本上依赖于错误发生的上下文(而不是其类型.) 既然异常类型不需要数据成员, 那么很自然的,抛出的异常对象可以从多个类型继承, 以表达不同的语义:<pre>struct exception_base: virtual std::exception, virtual boost::<spanclass="RenoLink"><a href="exception.html">exception</a> { };

 struct io_error: virtual exception_base { };
 struct file_error: virtual io_error { };
 struct read_error: virtual io_error { };
 struct file_read_error: virtual file_error, virtual read_error { };</pre>

-Using this approach, exception types become a simple tagging system forcategorizing errors and selecting failures in exception handlers.+使用这种方法, 异常类型就成为一个简单的标签系统,用来进行错误分类和异常处理.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="motivation.html">Motivation<br/>

</a><a href="using_virtual_inheritance_in_exception_types.html">UsingVirtual Inheritance in Exception Types 


Modified: trunk/libs/exception/doc/frequently_asked_questions.html
==============================================================================
--- trunk/libs/exception/doc/frequently_asked_questions.html    (original)

+++ trunk/libs/exception/doc/frequently_asked_questions.html Sun Jun 1417:49:43 2009

@@ -3,7 +3,7 @@
 <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>frequently asked questions</title>
+       <title>常问问题</title>
        <link href='reno.css' type='text/css' rel='stylesheet'/>
 </head>
 <body>
@@ -21,29 +21,29 @@

<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>Frequently AskedQuestions</h2>

 </div>
-<h3>Why doesn't boost::exception derive from std::exception?</h3>

-Despite that <ahref="using_virtual_inheritance_in_exception_types.html">virtualinheritance should be used in deriving from base exceptiontypes</a>, many programmers fail to follow this principle whenderiving from std::exception. If boost::<ahref="exception.html">exception</a> derives from std::exception,using the <ahref="enable_error_info.html">enable_error_info</a> function withsuch user-defined types would introduce dangerous ambiguity which wouldbreak all catch(std::exception &) statements.-Of course, boost::<ahref="exception.html">exception</a> should not be used to replacestd::exception as a base type in exception type hierarchies. Instead, itshould be included as a virtual base, in addition to std::exception (whichshould also be derived virtually.)

-<h3>Why is boost::exception abstract?</h3>

-To prevent exception-neutral contexts from erroneously erasing the typeof the original exception when adding <ahref="error_info.html">error_info</a> to an active exceptionobject:

+<h3>为什么 boost::exception 不是从std::exception 继承?</h3>

+尽管 <ahref="using_virtual_inheritance_in_exception_types.html">应该对基类异常使用虚拟继承</a>, 但是很多的程序员从 std::exception 继承的时候都忘记了这条原则. 如果 boost::<ahref="exception.html">exception</a>从 std::exception 继承, 对用户定义的异常类型使用函数 <ahref="enable_error_info.html">enable_error_info</a> 就会引入歧义, 从而破坏函数 catch(std::exception &) 执行.+当然, boost::<ahref="exception.html">exception</a> 不应该在异常体系中作为基类类型替换 std::exception . 相反, 它应该是作为虚拟基类和 std::exception 一起使用.(std::exception也应该被虚拟继承.)

+<h3>为什么 boost::exception 是抽象类 ?</h3>

+在异常中立的上下文中,向当前活动的异常对象添加 <ahref="error_info.html">error_info</a> 信息的时候, 很容易错误的删除异常的类型, 因此boost::exception 被设计为抽象类. 如下所示:<pre>catch( boost::<ahref="exception.html">exception</a> & e )

e <ahref="exception_operator_shl.html"><<</a> foo_info(foo);throw e; //Compile error: boost::<ahref="exception.html">exception</a> is abstract

     }</pre>
-<p>The correct code is:</p>
+<p>正确的做法是:</p>

<pre>catch( boost::<ahref="exception.html">exception</a> & e )

e <ahref="exception_operator_shl.html"><<</a> foo_info(foo);

     throw; //Okay, re-throwing the original exception object.
     }</pre>
-<h3>What is the space overhead of the boost::exception base class?</h3>

-The space overhead for the boost::exception data members is negligiblein the context of exception handling. Throwing objects that derive fromboost::<a href="exception.html">exception</a>does not by itself cause dynamic memory allocations.-Deriving from boost::<ahref="exception.html">exception</a> enables any data to be added toexceptions, which usually does allocate memory. However, this memory isreclaimed when the exception has been handled, and since typically usercode does not allocate memory during the unrolling of the stack, addingerror info to exceptions should not cause memory fragmentation.-<h3>Should I use boost::throw_exception or BOOST_THROW_EXCEPTION or justthrow?</h3>-The benefit of calling boost::<ahref="throw_exception.html">throw_exception</a> instead of usingthrow directly is that it ensures that the emitted exception derives fromboost::<a href="exception.html">exception</a>and that it is compatible with boost::<ahref="current_exception.html">current_exception</a>.-The <ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION</a> macroalso results in a call to boost::<ahref="throw_exception.html">throw_exception</a>, but in addition itrecords in the exception object the __FILE__ and __LINE__ of the throw, aswell as the pretty name of the function that throws. This has virtually nooverhead, yet enables boost::<ahref="diagnostic_information.html">diagnostic_information</a> tocompose a more useful, if not user-friendly message.-Typical use of boost::<ahref="diagnostic_information.html">diagnostic_information</a> is:

+<h3> boost::exception 基类的空间开销是多大 ?</h3>

+在异常处理过程中, boost::exception 的空间开销是可以忽略的. 抛出从boost::<a href="exception.html">exception</a>继承的异常本身不会引起任何的内存分配.+从 boost::<ahref="exception.html">exception</a> 继承,使得可以向异常对象添加任何数据, 这一般会导致分配内存. 但是, 这些内存会在异常处理以后被回收. 同时, 既然用户代码一般在栈展开的时候不会引起内存分配, 向异常对象添加错误信息一般不会引起内存碎片.+<h3>抛出异常的时候,应该使用 boost::throw_exception 还是BOOST_THROW_EXCEPTION, 或者只是简单的抛出 ?</h3>+使用 boost::<ahref="throw_exception.html">throw_exception</a> ,而不是简单的直接抛出, 带来的收益是确保抛出的异常从 boost::<ahref="exception.html">exception</a> 继承, 从而使之和函数boost::<ahref="current_exception.html">current_exception</a> 兼容.+宏 <ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION</a> 也会导致调用函数 boost::<ahref="throw_exception.html">throw_exception</a>, 但是会向异常对象添加 __FILE__ 和 __LINE__ 信息, 同时还有抛出函数的一个友好的名字信息. 这不会带来什么开销, 但是会使得 boost::<ahref="diagnostic_information.html">diagnostic_information</a> 含有一些更加有用, 即便不是用户友好的消息.+boost::<ahref="diagnostic_information.html">diagnostic_information</a> 的典型用法是:

 <pre>catch( boost::exception &amp; e )
     {
     std::cerr &lt;&lt; "OMG!" &lt;&lt; boost::diagnostic_information(e);
@@ -52,7 +52,7 @@
     {
     std::cerr &lt;&lt; "OMG!!!";
     }</pre>

-This is a possible message it may display, the first line is onlypossible if <ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION</a> isused:+下面是一条可能显示的消息格式, 第一行信息只有在调用 <spanclass="RenoLink"><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION</a> 才会出现:

 <pre>example_io.cpp(83): Throw in function void parse_file(const char *)
 Dynamic exception type: class file_open_error
 std::exception::what: example_io error
@@ -60,27 +60,27 @@
 [struct tag_file_name *] = tmp1.xml
 [struct tag_function *] = fopen
 [struct tag_open_mode *] = rb</pre>
-<h3>Why is boost::exception integrated in boost::throw_exception?</h3>

-The boost::<ahref="throw_exception.html">throw_exception</a> function predatesthe Boost Exception library and there has been some concern about itscurrent behavior of injecting boost::<ahref="exception.html">exception</a> as a base of any exceptionpassed to boost::<ahref="throw_exception.html">throw_exception</a>. Such concerns aredictated by the typical strict interpretation of a common principle in Cand C++, that users only pay for features they actually use.-The problem is that users of Boost Exception can't by themselves causea library to throw types that derive from boost::<ahref="exception.html">exception</a>, and without this they can't useany of the Boost Exception facilities.-For example, if a user wants to use Boost Serialization in a separatethread, it is desirable to be able to transport exceptions emitted by thatlibrary into the main thread where they can be analyzed to generate auser-friendly message. This can be easily achieved using boost::<spanclass="RenoLink"><a href="exception_ptr.html">exception_ptr</a>, butthis requires that Boost Serialization throws exceptions using boost::<spanclass="RenoLink"><ahref="enable_current_exception.html">enable_current_exception</a>.If Boost Serialization calls boost::<ahref="throw_exception.html">throw_exception</a> to throw, thisbehavior happens automatically and transparently.

-<p>The cost of this integration is:</p>

-<div><ul><li> In terms of space: a pointer and 3 ints are added to thestatic size of exception objects.</li>-<li> In terms of speed: the pointer is initialized to null at the point ofthe throw.</li>-<li> In terms of coupling: about 400 self-contained lines of C++ with noexternal includes.</li>

+<h3>boost::exception 为什么要和 boost::throw_exception 集成在一起 ?</h3>

+函数 boost::<ahref="throw_exception.html">throw_exception</a> 先于 Boost Exception函数库存在, 因此 boost::<ahref="exception.html">exception</a> 作为任何异常的基类传入到函数boost::<ahref="throw_exception.html">throw_exception</a> 当中所产生的行为就被特别的关注. 这些关注点也体现为 C 和 C++ 中一个通用的原则, 即用户仅需关注他们使用的特性 .+问题是 Boost Exception 的用用户自身不能使得一个函数库抛出的异常都是继承自 boost::<ahref="exception.html">exception</a>, 而不是这样就不能发挥 BoostException 的威力.+例如, 如果用户想在一个单独的线程中使用 Boost Serialization , 那么很自然的就希望把这个函数库抛出的异常传递到主线程中, 进行分析, 然后给出一个用户友好的消息. 通过 boost::<ahref="exception_ptr.html">exception_ptr</a> 可以很容易的实现这一点,但是这要求 Boost Serialization 通过 boost::<ahref="enable_current_exception.html">enable_current_exception</a> 抛出异常. 如果 Boost Serialization 通过 boost::<ahref="throw_exception.html">throw_exception</a> 抛出异常, 这种行为就会自动和透明的发生.

+<p>这种集成的代价是:</p>

+<div><ul><li> 空间占用方面: 异常对象的静态大小增加了一个指针和3个整数的大小.</li>

+<li> 速率方面: 在异常抛出点,指针被初始化为 null .</li>
+<li> 代码耦合方面: 增加 400 行自包含的, 没有外部连接的 C++ 代码.</li>
 </ul></div>
-<h3>Why use operator&lt;&lt; overload for adding info to exceptions?</h3>

-Before throwing an object of type that derives from boost::<spanclass="RenoLink"><a href="exception.html">exception</a>, it is oftendesirable to add one or more <ahref="error_info.html">error_info</a> objects in it. The syntacticsugar provided by <ahref="exception_operator_shl.html">exception/operator<<</a>allows this to be done directly in a throw expression:

+<h3>为什么使用操作符 &lt;&lt; 重载向异常对象添加信息 ?</h3>

+在抛出从 boost::<ahref="exception.html">exception</a> 继承的异常对象以前, 经常需要添加一个或者多个 <ahref="error_info.html">error_info</a> 对象. 操作符 <spanclass="RenoLink"><ahref="exception_operator_shl.html">exception/operator<<</a> 提供的语法糖使用起来很直接 :<pre>throw error() <ahref="exception_operator_shl.html"><<</a> foo_info(foo) <spanclass="RenoLink"><a href="exception_operator_shl.html"><<</a>bar_info(bar);</pre>

-<p>which saves typing compared to this possible alternative:</p>
+<p>和下面的这种方法相比, 这节省了不少的代码 :</p>
 <pre>error e;
 e.add(foo_info(foo));
 e.add(bar_info(bar));
 throw e;</pre>
-<p>and looks better than something like:</p>
+<p>和下面的形式相比也要更好:</p>
 <pre>throw error().add(foo_info(foo)).add(bar_info(bar));</pre>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="motivation.html">Motivation<br/>
 </a></div>

Modified: trunk/libs/exception/doc/functions.html
==============================================================================
--- trunk/libs/exception/doc/functions.html     (original)
+++ trunk/libs/exception/doc/functions.html     Sun Jun 14 17:49:43 2009
@@ -19,7 +19,7 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

-<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>Functions</h2>
+<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>函数</h2>
 </div>
 <div class="RenoIndex"><h3>c</h3>
 <p><a href="copy_exception.html">copy_exception</a></p>
@@ -45,7 +45,7 @@
 <p><a href="tuple_operator_shl.html">tuple/operator&lt;&lt;</a></p>
 </div>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a></div>
 </div>

Modified: trunk/libs/exception/doc/get_error_info.html
==============================================================================
--- trunk/libs/exception/doc/get_error_info.html        (original)
+++ trunk/libs/exception/doc/get_error_info.html        Sun Jun 14 17:49:43 2009
@@ -27,20 +27,20 @@
 <span class="RenoIncludeSPAN">    template &lt;class ErrorInfo,class E&gt;

typename ErrorInfo::<ahref="error_info_value_type.html">value_type</a> const * <spanclass="RenoLink">get_error_info( E const & x );

     }</pre>
-</div><h4>Requirements:</h4>

-<div><ul><li> ErrorInfo must be an instance of the <spanclass="RenoLink"><a href="error_info.html">error_info</a>template.</li>

-<li> E must be polymorphic.</li>
+</div><h4>要求:</h4>

+<div><ul><li> ErrorInfo 必须是模板 <ahref="error_info.html">error_info</a> 的实例.</li>

+<li> E 必须是多态类型的.</li>
 </ul></div>
-<h4>Returns:</h4>

-<div><ul><li> If dynamic_cast<boost::<ahref="exception.html">exception</a> const *>(&x) is 0, or ifx does not store an object of type ErrorInfo, the returned value isnull.</li>-<li> Otherwise, the returned pointer points to the stored value (use <spanclass="RenoLink"><ahref="exception_operator_shl.html">operator<<</a> to storevalues in exception objects.) When x is destroyed, any pointers returned byget_error_info become invalid.</li>

+<h4>返回值:</h4>

+<div><ul><li> 如果 dynamic_cast<boost::<ahref="exception.html">exception</a> const *>(&x) 等于 0, 或者x 没有存储任何 ErrorInfo 对象数据, 返回值是 null.</li>+<li> 否则, 返回的指针指向通过操作符 <ahref="exception_operator_shl.html">operator<<</a> 存储在异常对象中的数值.当 x 析构的时候, 通过 <spanclass="RenoLink">get_error_info 得到的指针变为无效.</li>

 </ul></div>
-<h4>Throws:</h4>
-<p>Nothing.</p>
-<h4>Note:</h4>

-The interface of get_error_info may beaffected by the build <ahref="configuration_macros.html">configuration macros</a>.

+<h4>异常抛出:</h4>
+<p>没有异常.</p>
+<h4>注意:</h4>

+函数 get_error_info 的接口会受宏 <spanclass="RenoLink"><a href="configuration_macros.html">configurationmacros</a>设置的影响.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION 

 </a><a href="boost-exception.html">Boost Exception<br/>

</a><ahref="exception_get_error_info_hpp.html">boost/exception/get_error_info.hpp 


Modified: trunk/libs/exception/doc/headers.html
==============================================================================
--- trunk/libs/exception/doc/headers.html       (original)
+++ trunk/libs/exception/doc/headers.html       Sun Jun 14 17:49:43 2009
@@ -19,7 +19,7 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

-<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>Headers</h2>
+<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>头文件</h2>
 </div>
 <div class="RenoIndex"><h3>e</h3>
 <p><a href="exception_hpp.html">boost/exception.hpp</a></p>
@@ -37,7 +37,7 @@
 <p><a href="throw_exception_hpp.html">boost/throw_exception.hpp</a></p>
 </div>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a></div>
 </div>

Modified: trunk/libs/exception/doc/macros.html
==============================================================================
--- trunk/libs/exception/doc/macros.html        (original)
+++ trunk/libs/exception/doc/macros.html        Sun Jun 14 17:49:43 2009
@@ -19,12 +19,12 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

-<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>Macros</h2>
+<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>宏</h2>
 </div>

<div class="RenoPageList"><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION 

 </a></div>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a></div>
 </div>

Modified: trunk/libs/exception/doc/motivation.html
==============================================================================
--- trunk/libs/exception/doc/motivation.html    (original)
+++ trunk/libs/exception/doc/motivation.html    Sun Jun 14 17:49:43 2009
@@ -19,23 +19,23 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

-<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>Motivation</h3>
+<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>动机</h3>
 </div>

-Traditionally, when using exceptions to report failures, the throwsite:

-<div><ul><li>creates an exception object of the appropriate type, and</li>
-<li>stuffs it with data relevant to the detected error.</li>
+<p>传统上, 使用异常机制报告错误, 在抛出端:</p>
+<div><ul><li>创建一个合适类型的异常对象, 并且</li>
+<li>向这个对象添加错误相关的数据.</li>
 </ul></div>
-<p>A higher context in the program contains a catch statement which:</p>
-<div><ul><li>selects failures based on exception types, and</li>

-<li>inspects exception objects for data required to deal with theproblem.</li>

+<p>在程序的高端包含一个catch 语句:</p>
+<div><ul><li>通过异常类型选择特定的错误,并且</li>
+<li>从异常对象中抽取相关的数据处理异常问题.</li>
 </ul></div>

-The main issue with this "traditional" approach is that often, the dataavailable at the point of the throw is insufficient for the catch site tohandle the failure.

-<p>Here is an example of a catch statement:</p>

+这种处理异常的 "传统" 方法经常导致在throw端缺乏catch端处理异常所需的足够信息.

+<p>下面是一个catch端得实例:</p>
 <pre>catch( file_read_error &amp; e )
     {
     std::cerr &lt;&lt; e.file_name();
     }</pre>
-<p>And here is a possible matching throw:</p>
+<p>还有一个匹配的throw端得实例:</p>
 <pre>void
 read_file( FILE * f )
     {
@@ -45,8 +45,8 @@
         throw file_read_error(???);
     ....
     }</pre>

-Clearly, the problem is that the handler requires a file name but theread_file function does not have a file name to put in the exceptionobject; all it has is a FILE pointer!-In an attempt to deal with this problem, we could modify read_file toaccept a file name:+很清楚, 问题是处理器需要一个文件名, 但是函数 read_file 不能向异常对象提供这个文件名; 它所拥有的只是一个 FILE 指针!

+<p>如果我们企图修改这个问题, 可能会修改函数 read_file ,增加一个文件名:</p>
 <pre>void
 read_file( FILE * f, char const * name )
     {
@@ -56,21 +56,21 @@
         throw file_read_error(name);
     ....
     }</pre>

-This is not a real solution: it simply shifts the burden of supplying afile name to the immediate caller of the read_file function.-<blockquote>In general, the data required to handle a givenlibrary-emitted exception depends on the program that links to it. Manycontexts between the throw and the catch may have relevant informationwhich must be transported to the exception handler.</blockquote>

-<h3>Exception wrapping</h3>

-The idea of exception wrapping is to catch an exception from a lowerlevel function (such as the read_file function above), and throw a newexception object that contains the original exception (and also carries afile name.) This method seems to be particularly popular with C++programmers with Java background.

-<p>Exception wrapping leads to the following problems:</p>

-<div><ul><li>To wrap an exception object it must be copied, which mayresult in slicing.</li>

-<li>Wrapping is practically impossible to use in generic contexts.</li>

+这不是一个真正的解决之道: 它只是简单的把提供文件名的负担转交给函数read_file 的调用者.+<blockquote>一般来说, 处理一个函数库抛出的异常所需的数据依赖于连接它的程序. 在throw和catch端得上下文含有异常处理必须的数据.</blockquote>

+<h3>异常包裹</h3>

+异常包裹,就是在在低端函数捕获异常 (例如上面的 read_file 函数), 然后重新抛出一个包含原始对象的新的异常对象 (包含文件名.) 这种方法对有Java背景的C++程序员来说,有特别的吸引力.

+<p>异常包裹会导致以下的问题:</p>
+<div><ul><li>要包裹的异常对象必须被拷贝,这可能会导致对象分裂.</li>
+<li>在泛型编程的上下文环境中, 异常对象的包裹实际上不可能.</li>
 </ul></div>

-The second point is actually special case of violating the exceptionneutrality principle. Most contexts in a program can not handle exceptions;such contexts should not interfere with the process of exceptionhandling.

-<h3>The boost::exception solution</h3>

-<div><ul><li>Simply derive your exception types from boost::<spanclass="RenoLink"><a href="exception.html">exception</a>.</li>-<li>Confidently limit the throw site to provide only data that isavailable naturally.</li>-<li>Use exception-neutral contexts between the throw and the catch toaugment exceptions with more relevant data as they bubble up.</li>+第二点实际上时违反异常中立原则的一个特例. 大多数的情况下程序不能处理异常,不能干扰异常处理的正常流程.

+<h3>boost::exception 的解决方案</h3>

+<div><ul><li>简单的从 boost::<ahref="exception.html">exception</a> 继承你需要的异常类型.</li>

+<li>在throw端, 很自然并且自信的把提供的数据限制为能力的范围之内.</li>

+<li>在throw和catch之间,在异常中立的上下文环境中, 向展开的异常对象添加相关的数据.</li>

 </ul></div>

-For example, in the throw statement below we only add the errno code,since this is the only failure-relevant information available in thiscontext:+例如, 在下面的throw语句中我们仅需添加错误代码 errno , 因为这是在当前能够得到的唯一的错误信息:<pre>struct exception_base: virtual std::exception, virtual boost::<spanclass="RenoLink"><a href="exception.html">exception</a> { };

 struct io_error: virtual exception_base { };
 struct file_read_error: virtual io_error { };
@@ -86,7 +86,7 @@

throw file_read_error() <ahref="exception_operator_shl.html"><<</a> errno_code(errno);

     ....
     }</pre>

-In a higher exception-neutral context, we add the file name toany exception that derives from boost::<ahref="exception.html">exception</a>:+在高端的异常中立的环境中, 我们把文件名添加到 任何 从boost::<ahref="exception.html">exception</a>继承的异常对象:<pre>typedef boost::<ahref="error_info.html">error_info</a><structtag_file_name,std::string> file_name;


 ....
@@ -108,7 +108,7 @@

e <ahref="exception_operator_shl.html"><<</a> file_name("foo.txt");

     throw;
     }</pre>

-Finally here is how the handler retrieves data from exceptions thatderive from boost::<ahref="exception.html">exception</a>:+最后, 基于boost::<ahref="exception.html">exception</a>抛出的异常对象, 异常处理器可以从中抽取文件名:

 <pre>catch( io_error &amp; e )
     {
     std::cerr &lt;&lt; "I/O Error!\n";
@@ -119,9 +119,9 @@

if( int const * c=<ahref="get_error_info.html">get_error_info</a><errno_code>(e) )

         std::cerr &lt;&lt; "OS says: " &lt;&lt; strerror(*c) &lt;&lt; "\n";
     }</pre>

-In addition, boost::<ahref="diagnostic_information.html">diagnostic_information</a> can beused to compose an automatic (if not user-friendly) message that containsall of the <ahref="error_info.html">error_info</a> objects added to aboost::<ahref="exception.html">exception</a>. This is useful for inclusion inlogs and other diagnostic objects.+另外, boost::<ahref="diagnostic_information.html">diagnostic_information</a> 可以用来自动合成所有的基于 <ahref="error_info.html">error_info</a> 向 boost::<spanclass="RenoLink"><a href="exception.html">exception</a>对象添加的消息文本(即便这样的消息不一定是用户友好的). 这对调试对象和日志对象是非常有用的.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><a href="exception_types_as_simple_semantic_tags.html">Exception Typesas Simple Semantic Tags </a><a href="frequently_asked_questions.html">Frequently AskedQuestions 


Modified: trunk/libs/exception/doc/page_idx.html
==============================================================================
--- trunk/libs/exception/doc/page_idx.html      (original)
+++ trunk/libs/exception/doc/page_idx.html      Sun Jun 14 17:49:43 2009
@@ -19,9 +19,9 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

-<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h1>Page Index</h1>
+<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h1>页面索引</h1>
 </div>

-This is an alphabetical list of all Boost Exception documentationpages.

+<p>这是一个字母排序的所有的 Boost Exception 文档列表.</p>
 <div class="RenoIndex"><h3>B</h3>
 <p><a href="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION</a></p>
 <h3>b</h3>
@@ -91,7 +91,7 @@
 <p><a href="unknown_exception.html">unknown_exception</a></p>
 </div>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a></div>
 </div>

Modified: trunk/libs/exception/doc/rethrow_exception.html
==============================================================================
--- trunk/libs/exception/doc/rethrow_exception.html     (original)
+++ trunk/libs/exception/doc/rethrow_exception.html     Sun Jun 14 17:49:43 2009
@@ -28,11 +28,11 @@

 void <spanclass="RenoLink">rethrow_exception( <ahref="exception_ptr.html">exception_ptr</a> const & ep );

     }</pre>
 </div><h4>Precondition:</h4>
-<p>ep shall not be null.</p>
-<h4>Throws:</h4>
-<p>The exception to which ep refers.</p>
+<p>ep 不能为空.</p>
+<h4>异常抛出:</h4>
+<p>ep 指定的异常.</p>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="exception_cloning_hpp.html">boost/exception_ptr.hpp<br/>
 </a><a href="exception_ptr.html">exception_ptr<br/>

Modified: trunk/libs/exception/doc/synopsis.html
==============================================================================
--- trunk/libs/exception/doc/synopsis.html      (original)
+++ trunk/libs/exception/doc/synopsis.html      Sun Jun 14 17:49:43 2009
@@ -20,7 +20,7 @@

 <div class="RenoIncludeDIV"><h2>Synopsis</h2>

-List of documented definitions, declarations and includes by headerfile:

+<p>通过头文件的文档定义声明的列表:</p>

#include<<ahref="exception_exception_hpp.html">boost/exception/exception.hpp</a>>

 <pre><span class="RenoIncludeSPAN">namespace
 boost
@@ -177,7 +177,7 @@

 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a></div>
 </div>

Modified: trunk/libs/exception/doc/throw_exception.html
==============================================================================
--- trunk/libs/exception/doc/throw_exception.html       (original)
+++ trunk/libs/exception/doc/throw_exception.html       Sun Jun 14 17:49:43 2009
@@ -32,16 +32,16 @@
     void <span class="RenoLink">throw_exception</span>( E const &amp; e );
 #endif</span>
     }</pre>
-</div><h4>Requirements:</h4>
-<p>E must derive publicly from std::exception.</p>
-<h4>Effects:</h4>

-<div><ul><li> If BOOST_NO_EXCEPTIONS is not defined, boost::<spanclass="RenoLink">throw_exception(e) is equivalent to throwboost::<ahref="enable_current_exception.html">enable_current_exception</a>(boost::<spanclass="RenoLink"><ahref="enable_error_info.html">enable_error_info</a>(e)), unlessBOOST_EXCEPTION_DISABLE is defined, in which case boost::<spanclass="RenoLink">throw_exception(e) is equivalent to throw e;</li>-<li> If BOOST_NO_EXCEPTIONS is defined, the function is left undefined,and the user is expected to supply an appropriate definition. Callers ofthrow_exception are allowed to assume thatthe function never returns; therefore, if the user-defined <spanclass="RenoLink">throw_exception returns, the behavior isundefined.</li>

+</div><h4>要求:</h4>
+<p>E 必须从继承自 std::exception.</p>
+<h4>效果:</h4>

+<div><ul><li> 如果 BOOST_NO_EXCEPTIONS 没有定义, 函数boost::<spanclass="RenoLink">throw_exception(e) 等价于 throw boost::<spanclass="RenoLink"><ahref="enable_current_exception.html">enable_current_exception</a>(boost::<spanclass="RenoLink"><ahref="enable_error_info.html">enable_error_info</a>(e)), 除非BOOST_EXCEPTION_DISABLE 被定义了, 在那种情况下 boost::<spanclass="RenoLink">throw_exception(e) 等价于 throw e;</li>+<li> 如果 BOOST_NO_EXCEPTIONS 被定义了, 那么这个函数没有被定义, 用户应该定义一个合适的实现. 函数throw_exception 的调用者可以合理的假定这个函数永不返回; 如果用户定义的函数返回了, 函数<spanclass="RenoLink">throw_exception 的行为时未定义的 .</li>

 </ul></div>
-<h4>Note:</h4>

-Under BOOST_NO_EXCEPTIONS, unless BOOST_EXCEPTION_DISABLE is alsodefined, users can examine the passed exception object using boost::<spanclass="RenoLink"><a href="get_error_info.html">get_error_info</a>,or format an automatic diagnostic message using boost::<spanclass="RenoLink"><ahref="diagnostic_information.html">diagnostic_information</a>.

+<h4>注意:</h4>

+定义宏 BOOST_NO_EXCEPTIONS, 并且宏 BOOST_EXCEPTION_DISABLE 也被定义, 用户才能使用函数 boost::<ahref="get_error_info.html">get_error_info</a> 操作传入的异常对象, 或者通过函数 boost::<ahref="diagnostic_information.html">diagnostic_information</a> 格式化自动产生的诊断消息.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION 

 </a><a href="boost-exception.html">Boost Exception<br/>
 </a><a href="throw_exception_hpp.html">boost/throw_exception.hpp<br/>

Modified: trunk/libs/exception/doc/throw_exception_hpp.html
==============================================================================
--- trunk/libs/exception/doc/throw_exception_hpp.html   (original)

+++ trunk/libs/exception/doc/throw_exception_hpp.html Sun Jun 14 17:49:432009

@@ -21,7 +21,7 @@

<div class="RenoIncludeDIV"><divclass="RenoAutoDIV"><h2>boost/throw_exception.hpp</h2>

 </div>
-<h3>Synopsis</h3>
+<h3>摘要</h3>

<div class="RenoIncludeDIV"><div class="RenoIncludeDIV"><pre><spanclass="RenoIncludeSPAN">#if !defined( BOOST_EXCEPTION_DISABLE )#include <<ahref="exception_exception_hpp.html">boost/exception/exception.hpp</a>>

     #include &lt;boost/current_function.hpp&gt;
@@ -45,7 +45,7 @@
 #endif</span>
     }</pre>
 </div></div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><ahref="BOOST_THROW_EXCEPTION.html">BOOST_THROW_EXCEPTION 

 </a><a href="configuration_macros.html">Configuration Macros<br/>
 </a><a href="synopsis.html">Synopsis<br/>

Modified: trunk/libs/exception/doc/tuple_operator_shl.html
==============================================================================
--- trunk/libs/exception/doc/tuple_operator_shl.html    (original)

+++ trunk/libs/exception/doc/tuple_operator_shl.html Sun Jun 14 17:49:432009

@@ -32,16 +32,16 @@
             ...,

<ahref="error_info.html">error_info</a><TagN,TN> > const& v );

     }</pre>
-</div><h4>Requirements:</h4>

-<h4>Effects:</h4>

-Equivalent to x << v.<ahref="http://www.boost.org/libs/tuple/doc/tuple_users_guide.html#accessing_elements";>get</a><0>()<< ... << v.<ahref="http://www.boost.org/libs/tuple/doc/tuple_users_guide.html#accessing_elements";>get</a><N>().

-<h4>Returns:</h4>
+</div><h4>要求:</h4>

+E 必须是 boost::<ahref="exception.html">exception</a>, 或者是从 boost::<spanclass="RenoLink"><a href="exception.html">exception</a> 直接或者间接继承的类型.

+<h4>效果:</h4>

+等价于 x << v.<ahref="http://www.boost.org/libs/tuple/doc/tuple_users_guide.html#accessing_elements";>get</a><0>()<< ... << v.<ahref="http://www.boost.org/libs/tuple/doc/tuple_users_guide.html#accessing_elements";>get</a><N>().

+<h4>返回值:</h4>
 <p>x.</p>
-<div class="RenoIncludeDIV"><h4>Throws:</h4>
-<p>std::bad_alloc, or any exception emitted by T1..TN copy constructor.</p>
+<div class="RenoIncludeDIV"><h4>异常抛出:</h4>
+<p>std::bad_alloc, 或者 T1..TN 拷贝构造函数抛出的异常 .</p>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><ahref="exception_error_info_group_hpp.html">boost/exception/info_tuple.hpp 

 </a></div>

Modified: trunk/libs/exception/doc/tutorial_diagnostic_information.html
==============================================================================
--- trunk/libs/exception/doc/tutorial_diagnostic_information.html       
(original)

+++ trunk/libs/exception/doc/tutorial_diagnostic_information.html Sun Jun14 17:49:43 2009

@@ -55,7 +55,7 @@
 [struct tag_function *] = fopen
 [struct tag_open_mode *] = rb</pre>
 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a></div>
 </div>

Modified: trunk/libs/exception/doc/tutorial_enable_error_info.html
==============================================================================
--- trunk/libs/exception/doc/tutorial_enable_error_info.html    (original)

+++ trunk/libs/exception/doc/tutorial_enable_error_info.html Sun Jun 1417:49:43 2009

@@ -51,7 +51,7 @@
 </pre>

The call to <ahref="enable_error_info.html">enable_error_info</a><T> gets usan object of unspecified type which is guaranteed to derive fromboth boost::<ahref="exception.html">exception</a> and T. This makes it possible touse <ahref="exception_operator_shl.html">operator<<</a> to storeadditional information in the exception object. The exception can beintercepted as T &, so existing exception handling will not break. Itcan also be intercepted as boost::<ahref="exception.html">exception</a> &, so that <spanclass="RenoLink"><a href="tutorial_transporting_data.html">more informationcan be added to the exception at a later time</a>.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="motivation.html">Motivation<br/>
 </a></div>

Modified: trunk/libs/exception/doc/tutorial_exception_ptr.html
==============================================================================
--- trunk/libs/exception/doc/tutorial_exception_ptr.html        (original)

+++ trunk/libs/exception/doc/tutorial_exception_ptr.html Sun Jun 1417:49:43 2009

@@ -22,7 +22,7 @@

<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>Transporting ofExceptions Between Threads</h2>

 </div>

Boost Exception supports transporting of exception objects betweenthreads through cloning. This system is similar to <spanclass="RenoLink"><ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2179.html";>N2179</a>,but because Boost Exception can not rely on language support, the use of<ahref="enable_current_exception.html">enable_current_exception</a> atthe time of the throw is required in order to use cloning.

-<h4>Note:</h4>
+<h4>注意:</h4>

All exceptions emitted by the familiar function boost::<spanclass="RenoLink"><a href="throw_exception.html">throw_exception</a>are guaranteed to derive from boost::<ahref="exception.html">exception</a> and to support cloning.<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>Usingenable_current_exception at the Time of the Throw</h3>

 </div>
@@ -84,7 +84,7 @@
 </ul></div>

Regardless, the use of <ahref="current_exception.html">current_exception</a> and <spanclass="RenoLink"><ahref="rethrow_exception.html">rethrow_exception</a> in the aboveexamples is well-formed.

 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a></div>
 </div>

Modified: trunk/libs/exception/doc/tutorial_transporting_data.html
==============================================================================
--- trunk/libs/exception/doc/tutorial_transporting_data.html    (original)

+++ trunk/libs/exception/doc/tutorial_transporting_data.html Sun Jun 1417:49:43 2009

@@ -19,16 +19,16 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

-<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>Transporting ofArbitrary Data to the Catch Site</h2>+<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h2>向catch端传递任意的数据</h2>

 </div>

-All exception types that derive from boost::<ahref="exception.html">exception</a> can be used as type-safecontainers of arbitrary data objects, while complying with the no-throwrequirements (15.5.1) of the ANSI C++ standard for exception types.-When exceptions derive from boost::<ahref="exception.html">exception</a>, arbitrary data can be added toexception objects:

-<div><ul><li>At the point of the throw;</li>
-<li>At a later time as exceptions bubble up the call stack.</li>

+所有从 boost::<ahref="exception.html">exception</a> 继承的子类对象都可以作为类型安全的任意数据的容器使用, 而且这个异常类型还遵从ANSI C++对异常类型无抛出规范(15.5.1)的要求.+当异常是从 boost::<ahref="exception.html">exception</a> 继承, 任何的数据都可以添加到异常对象中, 当:

+<div><ul><li>异常抛出的时候;</li>
+<li>在以后某个调用栈展开的时刻.</li>
 </ul></div>

<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>Adding ofArbitrary Data at the Point of the Throw</h3>

 </div>

-The following example demonstrates how errno can be stored in exceptionobjects using Boost Exception:

+<p>下面的实例说明了如何使用Boost Exception向异常对象添加errno:</p>

<pre>#include <<ahref="exception_hpp.html">boost/exception.hpp</a>>

 #include &lt;errno.h&gt;
 #include &lt;iostream&gt;
@@ -43,10 +43,10 @@
     throw my_error() &lt;&lt; errno_info(errno); //(3)
     }
 </pre>

-First, we instantiate the <ahref="error_info.html">error_info</a> template using a uniqueidentifier -- tag_errno, and the type of the info it identifies -- int.This provides compile-time type safety for the various values stored inexception objects.-Second, we define class my_error, which derives from boost::<spanclass="RenoLink"><a href="exception.html">exception</a>.-Finally, (3) illustrates how the typedef from (1) can be used with<ahref="exception_operator_shl.html">operator<<</a> to storevalues in exception objects at the point of the throw.

-<p>The stored errno value can be recovered at a later time like this:</p>

+首先, 我们使用唯一的标识符tag_errno和其对应的数据类型int实例化 <spanclass="RenoLink"><a href="error_info.html">error_info</a> 模板对象.这确保了向异常对象存储的各种数据对象是编译时类型安全的.+而后, 我们定义了 my_error, 这是一个从 boost::<ahref="exception.html">exception</a>继承的类型.+最后, (3) 说明了在异常对象的抛出点, 如何联合使用在 (1) 定义的typedef和操作符 <ahref="operator_shl_exception.html">operator<<</a> ,把数据存储在异常对象当中.

+<p>存储的 errno 数值可以在其后的某个时间像这样被恢复出来:</p>
 <pre>// ...continued

 void
@@ -63,18 +63,18 @@
             std::cerr &lt;&lt; "Error code: " &lt;&lt; *err;
         }
     }</pre>

-The <ahref="get_error_info.html">get_error_info</a> function template isinstantiated with the typedef from (1), and is passed an exception objectof a polymorphic type. If the exception object contains the requestedvalue, err will point to it; otherwise a null pointer is returned.-</div><div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>Adding ofArbitrary Data to Active Exception Objects</h3>+函数模板 <ahref="get_error_info.html">get_error_info</a> 通过(1)处的typedef实例化, 并传入多态类型的异常对象作为参数. 如果异常对象包含需要的数据, 返回的对象智能指针; 否则返回空指针.+</div><div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>向活动的异常对象添加任意的数据</h3>

 </div>

-Sometimes the throw site does not have all the information that isneeded at the catch site to make sense of what went wrong. Let's say wehave an exception type file_read_error, which takes a file name in itsconstructor. Consider the following function:+有时候 throw 端没有足够的信息, 这些信息使得catch端能够辨明错误的意义. 假定我们有一个异常对象,类型是 file_read_error, 它的的构造函数需要一个文件名作为参数. 考虑下面的函数:

 <pre>void
 file_read( FILE * f, void * buffer, size_t size )
     {
     if( size!=fread(buffer,1,size,f) )
         throw file_read_error(????);
     }</pre>

-How can the file_read function pass a file name to the exception typeconstructor? All it has is a FILE handle.-Using boost::<ahref="exception.html">exception</a> allows us to free the file_readfunction from the burden of storing the file name in exceptions itthrows:+函数 file_read 如何向异常类型的构造函数传递一个文件名作为参数 ? 它知道的全部信息是一个文件句柄对象.+使用 boost::<ahref="exception.html">exception</a> ,我们就不必再函数 file_read 进行异常抛出的时候向异常对象传入文件名参数:<pre>#include <<ahref="exception_hpp.html">boost/exception.hpp</a>>

 #include &lt;stdio.h&gt;
 #include &lt;errno.h&gt;
@@ -89,7 +89,7 @@
     if( size!=fread(buffer,1,size,f) )
         throw file_read_error() &lt;&lt; errno_info(errno);
     }</pre>

-If file_read detects a failure, it throws an exception which containsthe information that is available at the time, namely the errno. Otherrelevant information, such as the file name, can be added in a contexthigher up the call stack, where it is known naturally:+如果函数 file_read 检测到错误的发生, 他会抛出相关的异常对象, 其中包含当时能够得到的错误信息,即errno. 其他相关的信息,例如文件名, 可以在高端的调用堆栈上下文环境中得到,并添加到对象当中,那时它很自然的就知道了这个信息:<pre>#include <<ahref="exception_hpp.html">boost/exception.hpp</a>>

 #include &lt;boost/shared_ptr.hpp&gt;
 #include &lt;stdio.h&gt;
@@ -117,10 +117,10 @@
         throw;
         }
     }</pre>

-The above function is (almost) exception-neutral -- if an exception isemitted by any function call within the try block, parse_file does not needto do any real work, but it intercepts any boost::<ahref="exception.html">exception</a> object, stores the file name,and re-throws using a throw-expression with no operand (15.1.6). Therationale for catching any boost::<ahref="exception.html">exception</a> object is that the file name isrelevant to any failure that occurs in parse_file, even if the failureis unrelated to file I/O.-</div><div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>AddingGrouped Data to Exceptions</h3>+上面的实例(几乎)是异常中立的 -- 如果在try代码块中,任何的函数抛出了异常,parse_file 不需要做特别的工作, 而只是截获任何的 boost::<spanclass="RenoLink"><a href="exception.html">exception</a> 对象, 存储文件名,然后重新抛出. 截获 boost::<ahref="exception.html">exception</a> 对象是因为文件名和发生在函数parse_file 中的错误相关,即便是这个错误和文件 I/O 无关. +</div><div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>向异常对象添加组数据</h3>

 </div>

-The code snippet below demonstrates how boost::<spanclass="RenoLink"><ahref="http://www.boost.org/libs/tuple/doc/tuple_users_guide.html";>tuple</a>can be used to bundle the name of the function that failed, together withthe reported errno so that they can be added to exception objects moreconveniently together:+下面的代码片段展示了 boost::<ahref="http://www.boost.org/libs/tuple/doc/tuple_users_guide.html";>tuple</a>的用法, 用它把发生错误的函数名称和errno信息打包存储到异常对象当中,这样更加方便:<pre>#include <<ahref="exception_error_info_group_hpp.html">boost/exception/info_tuple.hpp</a>>

 #include &lt;boost/shared_ptr.hpp&gt;
 #include &lt;stdio.h&gt;
@@ -144,9 +144,9 @@
             file_name_info(name) &lt;&lt;
             clib_failure("fopen",errno);
     }</pre>

-Note that the members of a boost::<ahref="http://www.boost.org/libs/tuple/doc/tuple_users_guide.html";>tuple</a>are stored separately in exception objects; they can only be retrievedindividually, using <ahref="get_error_info.html">get_error_info</a>.+注意到 boost::<ahref="http://www.boost.org/libs/tuple/doc/tuple_users_guide.html";>tuple</a>的各个成员是单独存储到异常对象中的; 它们也只能单独的获取出来, 使用函数<ahref="get_error_info.html">get_error_info</a> .

 </div></div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><a href="tutorial_enable_error_info.html">Integrating Boost Exceptionin Existing Exception Class Hierarchies 

 </a></div>

Modified: trunk/libs/exception/doc/types.html
==============================================================================
--- trunk/libs/exception/doc/types.html (original)
+++ trunk/libs/exception/doc/types.html Sun Jun 14 17:49:43 2009
@@ -30,7 +30,7 @@
 <p><a href="unknown_exception.html">unknown_exception</a></p>
 </div>
 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a></div>
 </div>

Modified: trunk/libs/exception/doc/unknown_exception.html
==============================================================================
--- trunk/libs/exception/doc/unknown_exception.html     (original)
+++ trunk/libs/exception/doc/unknown_exception.html     Sun Jun 14 17:49:43 2009
@@ -33,9 +33,9 @@
         ---unspecified---
         };</span>
     }</pre>

-</div>This type is used by the <ahref="exception_ptr.html">exception_ptr</a> support in BoostException. Please see <ahref="current_exception.html">current_exception</a>.+</div>这个类型在 <ahref="exception_ptr.html">exception_ptr</a> 中使用. 参见 <spanclass="RenoLink"><ahref="current_exception.html">current_exception</a>.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException 

 </a><a href="exception_cloning_hpp.html">boost/exception_ptr.hpp<br/>
 </a><a href="current_exception.html">current_exception<br/>

Modified:trunk/libs/exception/doc/using_virtual_inheritance_in_exception_types.html

==============================================================================

---trunk/libs/exception/doc/using_virtual_inheritance_in_exception_types.html(original)+++trunk/libs/exception/doc/using_virtual_inheritance_in_exception_types.htmlSun Jun 14 17:49:43 2009

@@ -19,9 +19,9 @@
 <!-- Copyright (c) 2006-2009 Emil Dotchevski and Reverge Studios, Inc. -->

-<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>Using VirtualInheritance in Exception Types</h3>+<div class="RenoIncludeDIV"><div class="RenoAutoDIV"><h3>在异常类型之间使用虚拟继承</h3>

 </div>

-Exception types should use virtual inheritance when deriving from otherexception types. This insight is due to Andrew Koenig. Using virtualinheritance prevents ambiguity problems in the exception handler:+在异常对象之间应该使用虚拟继承, 这最早是由 Andrew Koenig 发现的.使用虚拟继承可以避免在异常处理中产生的歧义性:

 <pre>#include &lt;iostream&gt;
 struct my_exc1 : std::exception { char const* what() const throw(); };
 struct my_exc2 : std::exception { char const* what() const throw(); };
@@ -34,10 +34,10 @@
     catch(std::exception const&amp; e) {}
     catch(...) { std::cout &lt;&lt; "whoops!" &lt;&lt; std::endl; }
     }</pre>

-The program above outputs "whoops!" because the conversion tostd::exception is ambiguous.-The overhead introduced by virtual inheritance is always negligible inthe context of exception handling. Note that virtual bases are initializeddirectly by the constructor of the most-derived-type (the type passed tothe throw statement, in case of exceptions.) However, typically this detailis of no concern when boost::<ahref="exception.html">exception</a> is used, because it enablesexception types to be trivial structs with no members (there's nothing toinitialize.) See <ahref="exception_types_as_simple_semantic_tags.html">Exception Types asSimple Semantic Tags</a>.

+<p>上面的程序会输出 "whoops!" , 因为到 std::exception 的转换时歧义的.</p>

+在异常的处理的上下文中, 虚拟继承所产生的代价是微不足道的. 注意到虚基类是通过最顶端子类初始化的 (在异常处理中, 就是向throw语句传递的类型.) 但是, 典型的情况是使用 boost::<ahref="exception.html">exception</a> 类型的时候, 这种细节不值得关注,这是因为由于异常对象没有成员(这就不需要初始化).参见 <spanclass="RenoLink"><ahref="exception_types_as_simple_semantic_tags.html">Exception Types asSimple Semantic Tags</a>.

 </div><div class="RenoAutoDIV"><div class="RenoHR"><hr/></div>
-<h3>See Also:</h3>
+<h3>参见:</h3>

<div class="RenoPageList"><a href="boost-exception.html">BoostException </a><a href="frequently_asked_questions.html">Frequently AskedQuestions 

 </a></div>

[boost-doc-zh commit] r264 - for Version 1.39

Other related posts: