libstdc++
I/O

Classes

class  __gnu_cxx::stdio_filebuf< _CharT, _Traits >
 Provides a layer of compatibility for C/POSIX.This GNU extension provides extensions for working with standard C FILE*'s and POSIX file descriptors. It must be instantiated by the user with the type of character used in the file stream, e.g., stdio_filebuf<char>. More...
class  __gnu_cxx::stdio_sync_filebuf< _CharT, _Traits >
 Provides a layer of compatibility for C.This GNU extension provides extensions for working with standard C FILE*'s. It must be instantiated by the user with the type of character used in the file stream, e.g., stdio_filebuf<char>. More...
class  std::basic_filebuf< _CharT, _Traits >
 The actual work of input and output (for files).This class associates both its input and output sequence with an external disk file, and maintains a joint file position for both sequences. Many of its semantics are described in terms of similar behavior in the Standard C Library's FILE streams. More...
class  std::basic_fstream< _CharT, _Traits >
 Controlling input and output for files.This class supports reading from and writing to named files, using the inherited functions from std::basic_iostream. To control the associated sequence, an instance of std::basic_filebuf is used, which this page refers to as sb. More...
class  std::basic_ifstream< _CharT, _Traits >
 Controlling input for files.This class supports reading from named files, using the inherited functions from std::basic_istream. To control the associated sequence, an instance of std::basic_filebuf is used, which this page refers to as sb. More...
class  std::basic_ios< _CharT, _Traits >
 Virtual base class for all stream classes.Most of the member functions called dispatched on stream objects (e.g., std::cout.foo(bar);) are consolidated in this class. More...
class  std::basic_iostream< _CharT, _Traits >
 Template class basic_iostreamThis class multiply inherits from the input and output stream classes simply to provide a single interface. More...
class  std::basic_istream< _CharT, _Traits >
 Template class basic_istream.This is the base class for all input streams. It provides text formatting of all builtin types, and communicates with any class derived from basic_streambuf to do the actual input. More...
class  std::basic_istringstream< _CharT, _Traits, _Alloc >
 Controlling input for std::string.This class supports reading from objects of type std::basic_string, using the inherited functions from std::basic_istream. To control the associated sequence, an instance of std::basic_stringbuf is used, which this page refers to as sb. More...
class  std::basic_ofstream< _CharT, _Traits >
 Controlling output for files.This class supports reading from named files, using the inherited functions from std::basic_ostream. To control the associated sequence, an instance of std::basic_filebuf is used, which this page refers to as sb. More...
class  std::basic_ostream< _CharT, _Traits >
 Template class basic_ostream.This is the base class for all output streams. It provides text formatting of all builtin types, and communicates with any class derived from basic_streambuf to do the actual output. More...
class  std::basic_ostringstream< _CharT, _Traits, _Alloc >
 Controlling output for std::string.This class supports writing to objects of type std::basic_string, using the inherited functions from std::basic_ostream. To control the associated sequence, an instance of std::basic_stringbuf is used, which this page refers to as sb. More...
class  std::basic_streambuf< _CharT, _Traits >
 The actual work of input and output (interface).This is a base class. Derived stream buffers each control a pair of character sequences: one for input, and one for output. More...
class  std::basic_stringbuf< _CharT, _Traits, _Alloc >
 The actual work of input and output (for std::string).This class associates either or both of its input and output sequences with a sequence of characters, which can be initialized from, or made available as, a std::basic_string. (Paraphrased from [27.7.1]/1.) More...
class  std::basic_stringstream< _CharT, _Traits, _Alloc >
 Controlling input and output for std::string.This class supports reading from and writing to objects of type std::basic_string, using the inherited functions from std::basic_iostream. To control the associated sequence, an instance of std::basic_stringbuf is used, which this page refers to as sb. More...
class  std::ios_base
 The base of the I/O class hierarchy.This class defines everything that can be defined about I/O that does not depend on the type of characters being input or output. Most people will only see ios_base when they need to specify the full name of the various I/O flags (e.g., the openmodes). More...

Typedefs

typedef basic_filebuf< char > std::filebuf
typedef basic_fstream< char > std::fstream
typedef basic_ifstream< char > std::ifstream
typedef basic_ios< char > std::ios
typedef basic_iostream< char > std::iostream
typedef basic_istream< char > std::istream
typedef basic_istringstream< char > std::istringstream
typedef basic_ofstream< char > std::ofstream
typedef basic_ostream< char > std::ostream
typedef basic_ostringstream< char > std::ostringstream
typedef basic_streambuf< char > std::streambuf
typedef basic_stringbuf< char > std::stringbuf
typedef basic_stringstream< char > std::stringstream
typedef basic_filebuf< wchar_t > std::wfilebuf
typedef basic_fstream< wchar_t > std::wfstream
typedef basic_ifstream< wchar_t > std::wifstream
typedef basic_ios< wchar_t > std::wios
typedef basic_iostream< wchar_t > std::wiostream
typedef basic_istream< wchar_t > std::wistream
typedef basic_istringstream
< wchar_t > 
std::wistringstream
typedef basic_ofstream< wchar_t > std::wofstream
typedef basic_ostream< wchar_t > std::wostream
typedef basic_ostringstream
< wchar_t > 
std::wostringstream
typedef basic_streambuf< wchar_t > std::wstreambuf
typedef basic_stringbuf< wchar_t > std::wstringbuf
typedef basic_stringstream
< wchar_t > 
std::wstringstream

Detailed Description

Nearly all of the I/O classes are parameterized on the type of characters they read and write. (The major exception is ios_base at the top of the hierarchy.) This is a change from pre-Standard streams, which were not templates.

For ease of use and compatibility, all of the basic_* I/O-related classes are given typedef names for both of the builtin character widths (wide and narrow). The typedefs are the same as the pre-Standard names, for example:

typedef basic_ifstream<char> ifstream;

Because properly forward-declaring these classes can be difficult, you should not do it yourself. Instead, include the <iosfwd> header, which contains only declarations of all the I/O classes as well as the typedefs. Trying to forward-declare the typedefs themselves (e.g., class ostream;) is not valid ISO C++.

For more specific declarations, see http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch24.html


Typedef Documentation

typedef basic_filebuf<char> std::filebuf

Class for char file buffers.

Definition at line 156 of file iosfwd.

typedef basic_fstream<char> std::fstream

Class for char mixed input and output file streams.

Definition at line 165 of file iosfwd.

typedef basic_ifstream<char> std::ifstream

Class for char input file streams.

Definition at line 159 of file iosfwd.

typedef basic_ios<char> std::ios

Base class for char streams.

Definition at line 125 of file iosfwd.

typedef basic_iostream<char> std::iostream

Base class for char mixed input and output streams.

Definition at line 141 of file iosfwd.

typedef basic_istream<char> std::istream

Base class for char input streams.

Definition at line 135 of file iosfwd.

typedef basic_istringstream<char> std::istringstream

Class for char input memory streams.

Definition at line 147 of file iosfwd.

typedef basic_ofstream<char> std::ofstream

Class for char output file streams.

Definition at line 162 of file iosfwd.

typedef basic_ostream<char> std::ostream

Base class for char output streams.

Definition at line 138 of file iosfwd.

typedef basic_ostringstream<char> std::ostringstream

Class for char output memory streams.

Definition at line 150 of file iosfwd.

typedef basic_streambuf<char> std::streambuf

Base class for char buffers.

Definition at line 132 of file iosfwd.

typedef basic_stringbuf<char> std::stringbuf

Class for char memory buffers.

Definition at line 144 of file iosfwd.

typedef basic_stringstream<char> std::stringstream

Class for char mixed input and output memory streams.

Definition at line 153 of file iosfwd.

typedef basic_filebuf<wchar_t> std::wfilebuf

Class for wchar_t file buffers.

Definition at line 196 of file iosfwd.

typedef basic_fstream<wchar_t> std::wfstream

Class for wchar_t mixed input and output file streams.

Definition at line 205 of file iosfwd.

typedef basic_ifstream<wchar_t> std::wifstream

Class for wchar_t input file streams.

Definition at line 199 of file iosfwd.

typedef basic_ios<wchar_t> std::wios

Base class for wchar_t streams.

Definition at line 169 of file iosfwd.

typedef basic_iostream<wchar_t> std::wiostream

Base class for wchar_t mixed input and output streams.

Definition at line 181 of file iosfwd.

typedef basic_istream<wchar_t> std::wistream

Base class for wchar_t input streams.

Definition at line 175 of file iosfwd.

typedef basic_istringstream<wchar_t> std::wistringstream

Class for wchar_t input memory streams.

Definition at line 187 of file iosfwd.

typedef basic_ofstream<wchar_t> std::wofstream

Class for wchar_t output file streams.

Definition at line 202 of file iosfwd.

typedef basic_ostream<wchar_t> std::wostream

Base class for wchar_t output streams.

Definition at line 178 of file iosfwd.

typedef basic_ostringstream<wchar_t> std::wostringstream

Class for wchar_t output memory streams.

Definition at line 190 of file iosfwd.

typedef basic_streambuf<wchar_t> std::wstreambuf

Base class for wchar_t buffers.

Definition at line 172 of file iosfwd.

typedef basic_stringbuf<wchar_t> std::wstringbuf

Class for wchar_t memory buffers.

Definition at line 184 of file iosfwd.

typedef basic_stringstream<wchar_t> std::wstringstream

Class for wchar_t mixed input and output memory streams.

Definition at line 193 of file iosfwd.