aboutsummaryrefslogtreecommitdiff
path: root/libstdc++-v3/docs/html/ext/howto.html
diff options
context:
space:
mode:
Diffstat (limited to 'libstdc++-v3/docs/html/ext/howto.html')
-rw-r--r--libstdc++-v3/docs/html/ext/howto.html99
1 files changed, 61 insertions, 38 deletions
diff --git a/libstdc++-v3/docs/html/ext/howto.html b/libstdc++-v3/docs/html/ext/howto.html
index 3d08c570385..3289619625c 100644
--- a/libstdc++-v3/docs/html/ext/howto.html
+++ b/libstdc++-v3/docs/html/ext/howto.html
@@ -41,10 +41,11 @@
<ul>
<li><a href="#1">Ropes and trees and hashes, oh my!</a></li>
<li><a href="#2">Added members and types</a></li>
- <li><a href="#3">Allocators (versions 3.0, 3.1, 3.2)</a></li>
- <li><a href="#6">Allocators (version 3.3)</a></li>
+ <li><a href="#3">Allocators (versions 3.0, 3.1, 3.2, 3.3)</a></li>
+ <li><a href="#6">Allocators (version 3.4)</a></li>
<li><a href="#4">Compile-time checks</a></li>
<li><a href="#5">LWG Issues</a></li>
+ <li><a href="../18_support/howto.html#5">Demangling</a></li>
</ul>
<hr />
@@ -124,47 +125,16 @@
<a href="sgiexts.html">their own page</a>. Since the SGI STL is no
longer actively maintained, we will try and keep this code working
ourselves.</li>
- <li>3.0.x <code>filebuf</code>s have another ctor with this signature:
- <br />
- <code>basic_filebuf(__c_file_type*, ios_base::openmode, int_type);</code>
- <br />This comes in very handy in a number of places, such as
- attaching Unix sockets, pipes, and anything else which uses file
- descriptors, into the IOStream buffering classes. The three
- arguments are as follows:
- <ul>
- <li><code>__c_file_type* F </code>
- // the __c_file_type typedef usually boils down to stdio's FILE
- </li>
- <li><code>ios_base::openmode M </code>
- // same as all the other uses of openmode
- </li>
- <li><code>int_type B </code>
- // buffer size, defaults to BUFSIZ if not specified
- </li>
- </ul>
- For those wanting to use file descriptors instead of FILE*'s, I
- invite you to contemplate the mysteries of C's <code>fdopen()</code>.
- </li>
- <li>In library snapshot 3.0.95 and later, <code>filebuf</code>s bring
- back an old extension: the <code>fd()</code> member function. The
- integer returned from this function can be used for whatever file
- descriptors can be used for on your platform. Naturally, the
- library cannot track what you do on your own with a file descriptor,
- so if you perform any I/O directly, don't expect the library to be
- aware of it.
- </li>
- <li>Beginning with 3.1, the extra <code>filebuf</code> constructor and
- the <code>fd()</code> function were removed from the standard
- filebuf. Instead, <code>&lt;ext/stdio_filebuf.h&gt;</code> contains
- a derived class called <code>__gnu_cxx::stdio_filebuf</code>.
- </li>
+ <li>Extensions allowing <code>filebuf</code>s to be constructed from
+ stdio types are described in the
+ <a href="../27_io/howto.html#11">chapter 27 notes</a>.</li>
</ul>
<p>Return <a href="#top">to top of page</a> or
<a href="../faq/index.html">to the FAQ</a>.
</p>
<hr />
-<h2><a name="3">Allocators (versions 3.0, 3.1, 3.2)</a></h2>
+<h2><a name="3">Allocators (versions 3.0, 3.1, 3.2, 3.3)</a></h2>
<p>Thread-safety, space efficiency, high speed, portability... this is a
mess. Where to begin?
</p>
@@ -391,9 +361,14 @@
</p>
<hr />
-<h2><a name="6">Allocators (version 3.3)</a></h2>
+<h2><a name="6">Allocators (version 3.4)</a></h2>
<p>Changes are coming...
</p>
+ <p>If you plan on writing your own allocators,
+ <a href="../documentation.html#4">source documentation</a> is
+ available. You'll need to get the &quot;maintainers&quot; collection
+ in order to see the helper classes and extra notes.
+ </p>
<p>Return <a href="#top">to top of page</a> or
<a href="../faq/index.html">to the FAQ</a>.
</p>
@@ -456,6 +431,13 @@
<dd>Apparently extracting Boolean values was messed up...
</dd>
+ <dt><a href="lwg-defects.html#19">19</a>:
+ <em>&quot;Noconv&quot; definition too vague</em>
+ </dt>
+ <dd>If <code>codecvt::do_in</code> returns <code>noconv</code> there are
+ no changes to the values in <code>[to, to_limit)</code>.
+ </dd>
+
<dt><a href="lwg-defects.html#22">22</a>:
<em>Member open vs flags</em>
</dt>
@@ -488,6 +470,13 @@
&quot;copying stream state&quot; was deemed too complicated.
</dd>
+ <dt><a href="lwg-defects.html#60">60</a>:
+ <em>What is a formatted input function?</em>
+ </dt>
+ <dd>This DR made many widespread changes to <code>basic_istream</code>,
+ not all of which have been implemented.
+ </dd>
+
<dt><a href="lwg-defects.html#68">68</a>:
<em>Extractors for char* should store null at end</em>
</dt>
@@ -508,6 +497,13 @@
<code>max_size()</code> rather than <code>npos</code>.
</dd>
+ <dt><a href="lwg-defects.html#90">90</a>:
+ <em>Incorrect description of operator&gt;&gt; for strings</em>
+ </dt>
+ <dd>The effect contain <code>isspace(c,getloc())</code> which must be
+ replaced by <code>isspace(c,is.getloc())</code>.
+ </dd>
+
<dt><a href="lwg-defects.html#109">109</a>:
<em>Missing binders for non-const sequence elements</em>
</dt>
@@ -562,6 +558,12 @@
calculating an incorrect number of characters to write.
</dd>
+ <dt><a href="lwg-defects.html#171">171</a>:
+ <em>Strange seekpos() semantics due to joint position</em>
+ </dt>
+ <dd>Quite complex to summarize...
+ </dd>
+
<dt><a href="lwg-defects.html#181">181</a>:
<em>make_pair() unintended behavior</em>
</dt>
@@ -590,6 +592,20 @@
for const instances.
</dd>
+ <dt><a href="lwg-active.html#231">231</a>:
+ <em>Precision in iostream?</em>
+ </dt>
+ <dd>For conversion from a floating-point type, <code>str.precision()</code>
+ is specified in the conversion specification.
+ </dd>
+
+ <dt><a href="lwg-defects.html#235">235</a>:
+ <em>No specification of default ctor for reverse_iterator</em>
+ </dt>
+ <dd>The declaration of <code>reverse_iterator</code> lists a default constructor.
+ However, no specification is given what this constructor should do.
+ </dd>
+
<dt><a href="lwg-defects.html#251">251</a>:
<em>basic_stringbuf missing allocator_type</em>
</dt>
@@ -610,6 +626,13 @@
are trivial), since no description of them was ever given.
</dd>
+ <dt><a href="lwg-defects.html#271">271</a>:
+ <em>basic_iostream missing typedefs</em>
+ </dt>
+ <dd>The typedefs it inherits from its base classes can't be used, since
+ (for example) <code>basic_iostream&lt;T&gt;::traits_type</code> is ambiguous.
+ </dd>
+
<dt><a href="lwg-defects.html#275">275</a>:
<em>Wrong type in num_get::get() overloads</em>
</dt>