Added notes on interaction of different savers

[SVN r20818]
This commit is contained in:
Daryle Walker
2003-11-16 07:27:36 +00:00
parent 30431241e2
commit 3328463521

View File

@@ -215,7 +215,7 @@ attribute back to the saved value.</p>
</tr> </tr>
<tr> <tr>
<td><code>boost::io::basic_ios_iostate_saver&lt;Ch, Tr&gt;</code></td> <td><code>boost::io::basic_ios_iostate_saver&lt;Ch, Tr&gt;</code></td>
<td>Failure state of the stream <a href="#Note1">[1]</a></td> <td>Failure state of the stream <a href="#Note1">[1]</a>, <a href="#Note2">[2]</a></td>
<td><code>std::ios_base::iostate</code></td> <td><code>std::ios_base::iostate</code></td>
<td><code>rdstate</code></td> <td><code>rdstate</code></td>
<td><code>clear</code></td> <td><code>clear</code></td>
@@ -268,11 +268,13 @@ attribute back to the saved value.</p>
<li>When the associated stream buffer is changed, the stream's <li>When the associated stream buffer is changed, the stream's
failure state set is reset to &quot;good&quot; if the given stream failure state set is reset to &quot;good&quot; if the given stream
buffer's address is non-NULL, but the &quot;bad&quot; failure buffer's address is non-NULL, but the &quot;bad&quot; failure
state is set if that address is NULL. Given a NULL stream state is set if that address is NULL. This means that a saved
buffer address, an exception is thrown if the &quot;bad&quot; failure state of &quot;good&quot; may be restored as &quot;bad&quot;
failure state is being watched. This could mean that the <a if the stream is stripped of an associated stream buffer. Worse,
name="Note2">constructor or destructor of this class template given a NULL stream buffer address, an exception is thrown if the
may throw</a>.</li> &quot;bad&quot; failure state is being watched. This could mean
that the <a name="Note2">constructor or destructor of these class
templates may throw</a>.</li>
<li>The <a name="Note3">saver for the locale uses the <li>The <a name="Note3">saver for the locale uses the
<code>std::basic_ios&lt;Ch, Tr&gt;</code> class to extract their <code>std::basic_ios&lt;Ch, Tr&gt;</code> class to extract their
information</a>, although it could have used the functionality information</a>, although it could have used the functionality
@@ -431,6 +433,6 @@ int main()
<p>Copyright 2002 Daryle Walker. Use, modification, and distribution <p>Copyright 2002 Daryle Walker. Use, modification, and distribution
are subject to the Boost Software License, Version 1.0. (See accompanying are subject to the Boost Software License, Version 1.0. (See accompanying
file <a href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or a copy at file <a href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or a copy at
&lt;<a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>&gt;.</p> &lt;<a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>&gt;.)</p>
</body> </body>
</html> </html>