aboutsummaryrefslogtreecommitdiff
path: root/libstdc++-v3/docs/html/ext
diff options
context:
space:
mode:
authorJonathan Wakely <redi@gcc.gnu.org>2003-02-04 17:42:19 +0000
committerJonathan Wakely <redi@gcc.gnu.org>2003-02-04 17:42:19 +0000
commite7cc090e91b39ff34d75222a21a72d52f2ed6700 (patch)
tree4eebbff39e2426892a2ccf9e86b8d9b60c777ec5 /libstdc++-v3/docs/html/ext
parent9e80ada7a7b0f64f8340b64cd709d359d6bf383a (diff)
downloadgcc-e7cc090e91b39ff34d75222a21a72d52f2ed6700.zip
gcc-e7cc090e91b39ff34d75222a21a72d52f2ed6700.tar.gz
gcc-e7cc090e91b39ff34d75222a21a72d52f2ed6700.tar.bz2
howto.html: New section on stdio_filebuf.
2002-02-04 Jonathan Wakely <redi@gcc.gnu.org> * docs/html/27_io/howto.html: New section on stdio_filebuf. * docs/html/ext/howto.html: Move stdio_filebuf notes to 27_io. * docs/html/documentation.html: Regenerate. From-SVN: r62383
Diffstat (limited to 'libstdc++-v3/docs/html/ext')
-rw-r--r--libstdc++-v3/docs/html/ext/howto.html37
1 files changed, 3 insertions, 34 deletions
diff --git a/libstdc++-v3/docs/html/ext/howto.html b/libstdc++-v3/docs/html/ext/howto.html
index 3d08c57..07e5c27 100644
--- a/libstdc++-v3/docs/html/ext/howto.html
+++ b/libstdc++-v3/docs/html/ext/howto.html
@@ -124,40 +124,9 @@
<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>.