Public Types | |
typedef CharT | char_type |
typedef Traits | traits_type |
typedef traits_type::int_type | int_type |
typedef traits_type::pos_type | pos_type |
typedef traits_type::off_type | off_type |
enum | event |
The set of events that may be passed to an event callback. More... | |
typedef IosFmtflags | fmtflags |
This is a bitmask type. | |
typedef IosIostate | iostate |
This is a bitmask type. | |
typedef IosOpenmode | openmode |
This is a bitmask type. | |
typedef IosSeekdir | seekdir |
This is an enumerated type. | |
typedef void(* | event_callback )(event, ios_base &, int) |
The type of an event callback function. | |
Public Member Functions | |
basic_fstream () | |
Default constructor. | |
basic_fstream (const char *s, ios_base::openmode __mode=ios_base::in|ios_base::out) | |
Create an input/output file stream. | |
~basic_fstream () | |
The destructor does nothing. | |
__filebuf_type * | rdbuf () const |
Accessing the underlying buffer. | |
bool | is_open () |
Wrapper to test for an open file. | |
void | open (const char *s, ios_base::openmode __mode=ios_base::in|ios_base::out) |
Opens an external file. | |
void | close () |
Close the file. | |
streamsize | gcount () const |
Character counting. | |
iostate | rdstate () const |
Returns the error state of the stream buffer. | |
void | clear (iostate state=goodbit) |
[Re]sets the error state. | |
void | setstate (iostate state) |
Sets additional flags in the error state. | |
bool | good () const |
Fast error checking. | |
bool | eof () const |
Fast error checking. | |
bool | fail () const |
Fast error checking. | |
bool | bad () const |
Fast error checking. | |
iostate | exceptions () const |
Throwing exceptions on errors. | |
void | exceptions (iostate __except) |
Throwing exceptions on errors. | |
basic_ostream< CharT, Traits > * | tie () const |
Fetches the current tied stream. | |
basic_ostream< CharT, Traits > * | tie (basic_ostream< CharT, Traits > *__tiestr) |
Ties this stream to an output stream. | |
basic_streambuf< CharT, Traits > * | rdbuf (basic_streambuf< CharT, Traits > *sb) |
Changing the underlying buffer. | |
basic_ios & | copyfmt (const basic_ios &__rhs) |
Copies fields of __rhs into this. | |
char_type | fill () const |
Retreives the "empty" character. | |
char_type | fill (char_type ch) |
Sets a new "empty" character. | |
locale | imbue (const locale &__loc) |
Moves to a new locale. | |
char | narrow (char_type c, char __dfault) const |
Squeezes characters. | |
char_type | widen (char c) const |
Widens characters. | |
void | register_callback (event_callback __fn, int index) |
Add the callback __fn with parameter index. | |
fmtflags | flags () const |
Access to format flags. | |
fmtflags | flags (fmtflags __fmtfl) |
Setting new format flags all at once. | |
fmtflags | setf (fmtflags __fmtfl) |
Setting new format flags. | |
fmtflags | setf (fmtflags __fmtfl, fmtflags __mask) |
Setting new format flags. | |
void | unsetf (fmtflags __mask) |
Clearing format flags. | |
streamsize | precision () const |
Flags access. | |
streamsize | precision (streamsize __prec) |
Changing flags. | |
streamsize | width () const |
Flags access. | |
streamsize | width (streamsize __wide) |
Changing flags. | |
locale | getloc () const |
Locale access. | |
const locale & | M_getloc () const |
Locale access. | |
long & | iword (int __ix) |
Access to integer array. | |
void *& | pword (int __ix) |
Access to void pointer array. | |
__ostream_type & | flush () |
Synchronizing the stream buffer. | |
pos_type | tellp () |
Getting the current write position. | |
__ostream_type & | seekp (pos_type) |
Changing the current write position. | |
__ostream_type & | seekp (off_type, ios_base::seekdir) |
Changing the current write position. | |
__istream_type & | operator>> (__istream_type &(*__pf)(__istream_type &)) |
Interface for manipulators. | |
__istream_type & | operator>> (__ios_type &(*__pf)(__ios_type &)) |
Interface for manipulators. | |
__istream_type & | operator>> (ios_base &(*__pf)(ios_base &)) |
Interface for manipulators. | |
Arithmetic Extractors | |
All the operator>> functions (aka formatted input functions) have some common behavior. Each starts by constructing a temporary object of type std::basic_istream::sentry with the second argument (noskipws) set to false. This has several effects, concluding with the setting of a status flag; see the sentry documentation for more.If the sentry status is good, the function tries to extract whatever data is appropriate for the type of the argument.
If an exception is thrown during extraction, ios_base::badbit will be turned on in the stream's error state without causing an ios_base::failure to be thrown. The original exception will then be rethrown. | |
__istream_type & | operator>> (bool &n) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (short &n) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (unsigned short &n) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (int &n) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (unsigned int &n) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (long &n) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (unsigned long &n) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (float &__f) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (double &__f) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (long double &__f) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (void *&__p) |
Basic arithmetic extractors. | |
__istream_type & | operator>> (streambuf_type *sb) |
Extracting into another streambuf. | |
Unformatted Input Functions | |
All the unformatted input functions have some common behavior. Each starts by constructing a temporary object of type std::basic_istream::sentry with the second argument (noskipws) set to true. This has several effects, concluding with the setting of a status flag; see the sentry documentation for more. If the sentry status is good, the function tries to extract whatever data is appropriate for the type of the argument. The number of characters extracted is stored for later retrieval by gcount().
If an exception is thrown during extraction, ios_base::badbit will be turned on in the stream's error state without causing an ios_base::failure to be thrown. The original exception will then be rethrown. | |
int_type | get () |
Simple extraction. | |
__istream_type & | get (char_type &c) |
Simple extraction. | |
__istream_type & | get (char_type *s, streamsize n, char_type __delim) |
Simple multiple-character extraction. | |
__istream_type & | get (char_type *s, streamsize n) |
Simple multiple-character extraction. | |
__istream_type & | get (streambuf_type &sb, char_type __delim) |
Extraction into another streambuf. | |
__istream_type & | get (streambuf_type &sb) |
Extraction into another streambuf. | |
__istream_type & | getline (char_type *s, streamsize n, char_type __delim) |
String extraction. | |
__istream_type & | getline (char_type *s, streamsize n) |
String extraction. | |
__istream_type & | ignore (streamsize n=1, int_type __delim=traits_type::eof()) |
Discarding characters. | |
int_type | peek () |
Looking ahead in the stream. | |
__istream_type & | read (char_type *s, streamsize n) |
Extraction without delimiters. | |
streamsize | readsome (char_type *s, streamsize n) |
Extraction until the buffer is exhausted, but no more. | |
__istream_type & | putback (char_type c) |
Unextracting a single character. | |
__istream_type & | unget () |
Unextracting the previous character. | |
int | sync () |
Synchronizing the stream buffer. | |
pos_type | tellg () |
Getting the current read position. | |
__istream_type & | seekg (pos_type) |
Changing the current read position. | |
__istream_type & | seekg (off_type, ios_base::seekdir) |
Changing the current read position. | |
operator void * () const | |
The quick-and-easy status check. | |
bool | operator! () const |
The quick-and-easy status check. | |
__ostream_type & | operator<< (__ostream_type &(*__pf)(__ostream_type &)) |
Interface for manipulators. | |
__ostream_type & | operator<< (__ios_type &(*__pf)(__ios_type &)) |
Interface for manipulators. | |
__ostream_type & | operator<< (ios_base &(*__pf)(ios_base &)) |
Interface for manipulators. | |
Arithmetic Inserters | |
All the operator<< functions (aka formatted output functions) have some common behavior. Each starts by constructing a temporary object of type std::basic_ostream::sentry. This can have several effects, concluding with the setting of a status flag; see the sentry documentation for more.If the sentry status is good, the function tries to generate whatever data is appropriate for the type of the argument.
If an exception is thrown during insertion, ios_base::badbit will be turned on in the stream's error state without causing an ios_base::failure to be thrown. The original exception will then be rethrown. | |
__ostream_type & | operator<< (long n) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (unsigned long n) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (bool n) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (short n) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (unsigned short n) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (int n) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (unsigned int n) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (double __f) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (float __f) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (long double __f) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (const void *__p) |
Basic arithmetic inserters. | |
__ostream_type & | operator<< (streambuf_type *sb) |
Extracting from another streambuf. | |
Unformatted Output Functions | |
All the unformatted output functions have some common behavior. Each starts by constructing a temporary object of type std::basic_ostream::sentry. This has several effects, concluding with the setting of a status flag; see the sentry documentation for more. If the sentry status is good, the function tries to generate whatever data is appropriate for the type of the argument.
If an exception is thrown during insertion, ios_base::badbit will be turned on in the stream's error state. If badbit is on in the stream's exceptions mask, the exception will be rethrown without completing its actions. | |
__ostream_type & | put (char_type c) |
Simple insertion. | |
void | M_write (const char_type *s, streamsize n) |
Simple insertion. | |
__ostream_type & | write (const char_type *s, streamsize n) |
Character string insertion. | |
Static Public Member Functions | |
static bool | sync_with_stdio (bool sync=true) |
Interaction with the standard C I/O objects. | |
static int | xalloc () throw () |
Access to unique indices. | |
Static Public Attributes | |
static const fmtflags | boolalpha |
Insert/extract bool in alphabetic rather than numeric format. | |
static const fmtflags | dec |
Converts integer input or generates integer output in decimal base. | |
static const fmtflags | fixed |
Generate floating-point output in fixed-point notation. | |
static const fmtflags | hex |
Converts integer input or generates integer output in hexadecimal base. | |
static const fmtflags | internal |
Adds fill characters at a designated internal point in certain generated output, or identical to right if no such point is designated. | |
static const fmtflags | left |
Adds fill characters on the right (final positions) of certain generated output. (I.e., the thing you print is flush left.). | |
static const fmtflags | oct |
Converts integer input or generates integer output in octal base. | |
static const fmtflags | right |
Adds fill characters on the left (initial positions) of certain generated output. (I.e., the thing you print is flush right.). | |
static const fmtflags | scientific |
Generates floating-point output in scientific notation. | |
static const fmtflags | showbase |
Generates a prefix indicating the numeric base of generated integer output. | |
static const fmtflags | showpoint |
Generates a decimal-point character unconditionally in generated floating-point output. | |
static const fmtflags | showpos |
Generates a + sign in non-negative generated numeric output. | |
static const fmtflags | skipws |
Skips leading white space before certain input operations. | |
static const fmtflags | unitbuf |
Flushes output after each output operation. | |
static const fmtflags | uppercase |
Replaces certain lowercase letters with their uppercase equivalents in generated output. | |
static const fmtflags | adjustfield |
A mask of left|right|internal. Useful for the 2-arg form of setf . | |
static const fmtflags | basefield |
A mask of dec|oct|hex. Useful for the 2-arg form of setf . | |
static const fmtflags | floatfield |
A mask of scientific|fixed. Useful for the 2-arg form of setf . | |
static const iostate | badbit |
Indicates a loss of integrity in an input or output sequence (such as an irrecoverable read error from a file). | |
static const iostate | eofbit |
Indicates that an input operation reached the end of an input sequence. | |
static const iostate | failbit |
Indicates that an input operation failed to read the expected characters, or that an output operation failed to generate the desired characters. | |
static const iostate | goodbit |
Indicates all is well. | |
static const openmode | app |
Seek to end before each write. | |
static const openmode | ate |
Open and seek to end immediately after opening. | |
static const openmode | binary |
Perform input and output in binary mode (as opposed to text mode). This is probably not what you think it is; see http://gcc.gnu.org/onlinedocs/libstdc++/27_io/howto.html#3 and http://gcc.gnu.org/onlinedocs/libstdc++/27_io/howto.html#7 for more. | |
static const openmode | in |
Open for input. Default for ifstream and fstream. | |
static const openmode | out |
Open for output. Default for ofstream and fstream. | |
static const openmode | trunc |
Open for input. Default for ofstream . | |
static const seekdir | beg |
Request a seek relative to the beginning of the stream. | |
static const seekdir | cur |
Request a seek relative to the current position within the sequence. | |
static const seekdir | end |
Request a seek relative to the current end of the sequence. | |
Protected Member Functions | |
void | init (basic_streambuf< CharT, Traits > *sb) |
All setup is performed here. |
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
.
Definition at line 725 of file fstream.
typedef CharT std::basic_fstream< CharT, Traits >::char_type |
These are standard types. They permit a standardized way of referring to names of (or names dependant on) the template parameters, which are specific to the implementation.
Reimplemented from std::basic_iostream< CharT, Traits >.
typedef Traits std::basic_fstream< CharT, Traits >::traits_type |
These are standard types. They permit a standardized way of referring to names of (or names dependant on) the template parameters, which are specific to the implementation.
Reimplemented from std::basic_iostream< CharT, Traits >.
typedef traits_type::int_type std::basic_fstream< CharT, Traits >::int_type |
These are standard types. They permit a standardized way of referring to names of (or names dependant on) the template parameters, which are specific to the implementation.
Reimplemented from std::basic_iostream< CharT, Traits >.
typedef traits_type::pos_type std::basic_fstream< CharT, Traits >::pos_type |
These are standard types. They permit a standardized way of referring to names of (or names dependant on) the template parameters, which are specific to the implementation.
Reimplemented from std::basic_iostream< CharT, Traits >.
typedef traits_type::off_type std::basic_fstream< CharT, Traits >::off_type |
These are standard types. They permit a standardized way of referring to names of (or names dependant on) the template parameters, which are specific to the implementation.
Reimplemented from std::basic_iostream< CharT, Traits >.
typedef IosFmtflags std::ios_base::fmtflags [inherited] |
This is a bitmask type.
"IosFmtflags"
is implementation-defined, but it is valid to perform bitwise operations on these values and expect the Right Thing to happen. Defined objects of type fmtflags are:
Definition at line 253 of file ios_base.h.
typedef IosIostate std::ios_base::iostate [inherited] |
This is a bitmask type.
"IosIostate"
is implementation-defined, but it is valid to perform bitwise operations on these values and expect the Right Thing to happen. Defined objects of type iostate are:
Definition at line 328 of file ios_base.h.
typedef IosOpenmode std::ios_base::openmode [inherited] |
This is a bitmask type.
"IosOpenmode"
is implementation-defined, but it is valid to perform bitwise operations on these values and expect the Right Thing to happen. Defined objects of type openmode are:
Definition at line 359 of file ios_base.h.
typedef IosSeekdir std::ios_base::seekdir [inherited] |
This is an enumerated type.
"IosSeekdir"
is implementation-defined. Defined values of type seekdir are:
SEEKCUR
in the C standard library.SEEKEND
in the C standard library. Definition at line 392 of file ios_base.h.
typedef void(* std::ios_base::event_callback)(event, ios_base &, int) [inherited] |
The type of an event callback function.
event | One of the members of the event enum. | |
ios_base | Reference to the ios_base object. | |
int | The integer provided when the callback was registered. |
enum std::ios_base::event [inherited] |
The set of events that may be passed to an event callback.
erase_event is used during ~ios() and copyfmt(). imbue_event is used during imbue(). copyfmt_event is used during copyfmt().
Definition at line 420 of file ios_base.h.
std::basic_fstream< CharT, Traits >::basic_fstream | ( | ) | [inline] |
Default constructor.
Initializes sb
using its default constructor, and passes &sb
to the base class initializer. Does not open any files (you haven't given it a filename to open).
Definition at line 757 of file fstream.
References std::basic_ios< CharT, Traits >::init().
std::basic_fstream< CharT, Traits >::basic_fstream | ( | const char * | s, | |
ios_base::openmode | __mode = ios_base::in | ios_base::out | |||
) | [inline, explicit] |
Create an input/output file stream.
s | Null terminated string specifying the filename. | |
mode | Open file in specified mode (see std::ios_base). |
Definition at line 770 of file fstream.
References std::basic_ios< CharT, Traits >::init(), and std::basic_fstream< CharT, Traits >::open().
std::basic_fstream< CharT, Traits >::~basic_fstream | ( | ) | [inline] |
__filebuf_type* std::basic_fstream< CharT, Traits >::rdbuf | ( | ) | const [inline] |
Accessing the underlying buffer.
Reimplemented from std::basic_ios< CharT, Traits >.
bool std::basic_fstream< CharT, Traits >::is_open | ( | ) | [inline] |
void std::basic_fstream< CharT, Traits >::open | ( | const char * | s, | |
ios_base::openmode | __mode = ios_base::in | ios_base::out | |||
) | [inline] |
Opens an external file.
s | The name of the file. | |
mode | The open mode flags. |
std::basic_filebuf::open(s,mode)
. If that function fails, failbit
is set in the stream's error state.Tip: When using std::string to hold the filename, you must use .c_str() before passing it to this constructor.
Definition at line 817 of file fstream.
References std::ios_base::failbit, and std::basic_ios< CharT, Traits >::setstate().
Referenced by std::basic_fstream< CharT, Traits >::basic_fstream().
void std::basic_fstream< CharT, Traits >::close | ( | ) | [inline] |
Close the file.
Calls std::basic_filebuf::close()
. If that function fails, failbit
is set in the stream's error state.
Definition at line 831 of file fstream.
References std::ios_base::failbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | __istream_type &(*)(__istream_type &) | __pf | ) | [inline, inherited] |
Interface for manipulators.
Manuipulators such as std::ws
and std::dec
use these functions in constructs like "std::cin >> std::ws". For more information, see the iomanip header.
Definition at line 86 of file istream.tcc.
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | __ios_type &(*)(__ios_type &) | __pf | ) | [inline, inherited] |
Interface for manipulators.
Manuipulators such as std::ws
and std::dec
use these functions in constructs like "std::cin >> std::ws". For more information, see the iomanip header.
Definition at line 92 of file istream.tcc.
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | ios_base &(*)(ios_base &) | __pf | ) | [inline, inherited] |
Interface for manipulators.
Manuipulators such as std::ws
and std::dec
use these functions in constructs like "std::cin >> std::ws". For more information, see the iomanip header.
Definition at line 101 of file istream.tcc.
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | bool & | n | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 110 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | short & | n | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 132 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::failbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | unsigned short & | n | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 163 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | int & | n | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 185 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::failbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | unsigned int & | n | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 216 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | long & | n | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 238 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | unsigned long & | n | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 260 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | float & | __f | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 328 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | double & | __f | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 350 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | long double & | __f | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 372 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | void *& | __p | ) | [inline, inherited] |
Basic arithmetic extractors.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to parse the input data.
Definition at line 394 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::operator>> | ( | streambuf_type * | sb | ) | [inline, inherited] |
Extracting into another streambuf.
sb | A pointer to a streambuf |
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from this stream and inserted into the sb streambuf until one of the following occurs:
If the function inserts no characters, failbit is set.
Definition at line 416 of file istream.tcc.
References std::ios_base::failbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
streamsize std::basic_istream< CharT, Traits >::gcount | ( | ) | const [inline, inherited] |
basic_istream< CharT, Traits >::int_type std::basic_istream< CharT, Traits >::get | ( | void | ) | [inline, inherited] |
Simple extraction.
Definition at line 440 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::eofbit, std::ios_base::failbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::get | ( | char_type & | c | ) | [inline, inherited] |
Simple extraction.
c | The character in which to store data. |
Definition at line 471 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::eofbit, std::ios_base::failbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::get | ( | char_type * | s, | |
streamsize | n, | |||
char_type | __delim | |||
) | [inline, inherited] |
Simple multiple-character extraction.
s | Pointer to an array. | |
n | Maximum number of characters to store in s. | |
delim | A "stop" character. |
n-1
characters are storedIf no characters are stored, failbit is set in the stream's error state.
In any case, a null character is stored into the next location in the array.
Definition at line 503 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::eofbit, std::ios_base::failbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
__istream_type& std::basic_istream< CharT, Traits >::get | ( | char_type * | s, | |
streamsize | n | |||
) | [inline, inherited] |
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::get | ( | streambuf_type & | sb, | |
char_type | __delim | |||
) | [inline, inherited] |
Extraction into another streambuf.
sb | A streambuf in which to store data. | |
delim | A "stop" character. |
If no characters are stored, failbit is set in the stream's error state.
Definition at line 542 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::eofbit, std::ios_base::failbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
__istream_type& std::basic_istream< CharT, Traits >::get | ( | streambuf_type & | sb | ) | [inline, inherited] |
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::getline | ( | char_type * | s, | |
streamsize | n, | |||
char_type | __delim | |||
) | [inline, inherited] |
String extraction.
s | A character array in which to store the data. | |
n | Maximum number of characters to extract. | |
delim | A "stop" character. |
delim
, in which case the character is extracted (and therefore counted in gcount()
) but not storedn-1
characters are stored, in which case failbit is set in the stream error stateIf no characters are extracted, failbit is set. (An empty line of input should therefore not cause failbit to be set.)
In any case, a null character is stored in the next location in the array.
Definition at line 581 of file istream.tcc.
References std::ios_base::badbit, std::copy(), std::ios_base::eofbit, std::ios_base::failbit, std::find(), std::ios_base::goodbit, std::min(), std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
Referenced by std::getline(), and std::basic_istream< char >::getline().
__istream_type& std::basic_istream< CharT, Traits >::getline | ( | char_type * | s, | |
streamsize | n | |||
) | [inline, inherited] |
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::ignore | ( | streamsize | n = 1 , |
|
int_type | __delim = traits_type::eof() | |||
) | [inline, inherited] |
Discarding characters.
n | Number of characters to discard. | |
delim | A "stop" character. |
!=
std::numeric_limits<int>::max()
, n characters are extractedtraits::eof()
. Definition at line 647 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::eofbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits >::int_type std::basic_istream< CharT, Traits >::peek | ( | void | ) | [inline, inherited] |
Looking ahead in the stream.
good()
is false, returns traits::eof()
. Otherwise reads but does not extract the next input character.
Definition at line 683 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::eofbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::read | ( | char_type * | s, | |
streamsize | n | |||
) | [inline, inherited] |
Extraction without delimiters.
s | A character array. | |
n | Maximum number of characters to store. |
good()
, extracts characters and stores them into s until one of the following happens:failbit|eofbit
.
Definition at line 708 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::eofbit, std::ios_base::failbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
streamsize std::basic_istream< CharT, Traits >::readsome | ( | char_type * | s, | |
streamsize | n | |||
) | [inline, inherited] |
Extraction until the buffer is exhausted, but no more.
s | A character array. | |
n | Maximum number of characters to store. |
rdbuf()->in_avail()
, called A
here:A
==
-1
, sets eofbit and extracts no charactersA
==
0
, extracts no charactersA
>
0
, extracts min(A,n)
The goal is to empty the current buffer, and to not request any more from the external input sequence controlled by the streambuf.
Definition at line 732 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::eofbit, std::ios_base::goodbit, std::min(), std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::putback | ( | char_type | c | ) | [inline, inherited] |
Unextracting a single character.
c | The character to push back into the input stream. |
rdbuf()
is not null, calls rdbuf()->sputbackc(c)
.
If rdbuf()
is null or if sputbackc()
fails, sets badbit in the error state.
gcount()
will return 0, as required by DR 60. Definition at line 759 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
Referenced by std::operator>>().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::unget | ( | void | ) | [inline, inherited] |
Unextracting the previous character.
rdbuf()
is not null, calls rdbuf()->sungetc(c)
.
If rdbuf()
is null or if sungetc()
fails, sets badbit in the error state.
gcount()
will return 0, as required by DR 60. Definition at line 787 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
int std::basic_istream< CharT, Traits >::sync | ( | void | ) | [inline, inherited] |
Synchronizing the stream buffer.
rdbuf()
is a null pointer, returns -1.
Otherwise, calls rdbuf()->pubsync()
, and if that returns -1, sets badbit and returns -1.
Otherwise, returns 0.
gcount()
. Definition at line 815 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits >::pos_type std::basic_istream< CharT, Traits >::tellg | ( | void | ) | [inline, inherited] |
Getting the current read position.
fail()
is not false, returns pos_type
(-1) to indicate failure. Otherwise returns rdbuf()->pubseekoff(0,cur,in)
.
gcount()
. Definition at line 846 of file istream.tcc.
References std::ios_base::badbit, std::ios_base::cur, std::basic_ios< CharT, Traits >::fail(), std::ios_base::in, and std::basic_ios< CharT, Traits >::rdbuf().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::seekg | ( | pos_type | position | ) | [inline, inherited] |
Changing the current read position.
pos | A file position object. |
fail()
is not true, calls rdbuf()->pubseekpos(pos)
. If that function fails, sets failbit.
gcount()
. Definition at line 864 of file istream.tcc.
References std::ios_base::badbit, std::basic_ios< CharT, Traits >::fail(), std::ios_base::failbit, std::ios_base::goodbit, std::ios_base::in, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_istream< CharT, Traits > & std::basic_istream< CharT, Traits >::seekg | ( | off_type | __off, | |
ios_base::seekdir | __dir | |||
) | [inline, inherited] |
Changing the current read position.
off | A file offset object. | |
dir | The direction in which to seek. |
fail()
is not true, calls rdbuf()->pubseekoff(off,dir)
. If that function fails, sets failbit.
gcount()
. Definition at line 892 of file istream.tcc.
References std::ios_base::badbit, std::basic_ios< CharT, Traits >::fail(), std::ios_base::failbit, std::ios_base::goodbit, std::ios_base::in, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
std::basic_ios< CharT, Traits >::operator void * | ( | ) | const [inline, inherited] |
The quick-and-easy status check.
This allows you to write constructs such as "if (!a_stream) ..." and "while (a_stream) ..."
Definition at line 107 of file basic_ios.h.
bool std::basic_ios< CharT, Traits >::operator! | ( | ) | const [inline, inherited] |
The quick-and-easy status check.
This allows you to write constructs such as "if (!a_stream) ..." and "while (a_stream) ..."
Definition at line 111 of file basic_ios.h.
iostate std::basic_ios< CharT, Traits >::rdstate | ( | ) | const [inline, inherited] |
Returns the error state of the stream buffer.
Definition at line 123 of file basic_ios.h.
Referenced by std::basic_ios< char, Traits >::bad(), std::basic_ios< CharT, Traits >::clear(), std::basic_ios< char, Traits >::eof(), std::basic_ios< char, Traits >::fail(), std::basic_ios< char, Traits >::good(), and std::basic_ios< char, Traits >::setstate().
void std::basic_ios< CharT, Traits >::clear | ( | iostate | state = goodbit |
) | [inline, inherited] |
[Re]sets the error state.
state | The new state flag(s) to set. |
Definition at line 39 of file basic_ios.tcc.
References std::ios_base::badbit, std::basic_ios< CharT, Traits >::exceptions(), std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::rdstate().
Referenced by std::basic_ios< char, Traits >::exceptions(), std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< char, Traits >::setstate().
void std::basic_ios< CharT, Traits >::setstate | ( | iostate | state | ) | [inline, inherited] |
Sets additional flags in the error state.
state | The additional state flag(s) to set. |
Definition at line 143 of file basic_ios.h.
Referenced by std::basic_fstream< CharT, Traits >::close(), std::basic_ofstream< CharT, Traits >::close(), std::basic_ifstream< CharT, Traits >::close(), std::basic_ostream< CharT, Traits >::flush(), std::basic_istream< CharT, Traits >::get(), std::getline(), std::basic_istream< CharT, Traits >::getline(), std::basic_istream< CharT, Traits >::ignore(), std::basic_ostream< char >::M_write(), std::basic_fstream< CharT, Traits >::open(), std::basic_ofstream< CharT, Traits >::open(), std::basic_ifstream< CharT, Traits >::open(), std::basic_ostream< CharT, Traits >::operator<<(), std::basic_istream< CharT, Traits >::operator>>(), std::operator>>(), std::basic_istream< CharT, Traits >::peek(), std::basic_ostream< CharT, Traits >::put(), std::basic_istream< CharT, Traits >::putback(), std::basic_istream< CharT, Traits >::read(), std::basic_istream< CharT, Traits >::readsome(), std::basic_istream< CharT, Traits >::seekg(), std::basic_ostream< CharT, Traits >::seekp(), std::basic_ostream< CharT, Traits >::sentry::sentry(), std::basic_istream< CharT, Traits >::sentry::sentry(), std::basic_istream< CharT, Traits >::sync(), std::basic_istream< CharT, Traits >::unget(), and std::ws().
bool std::basic_ios< CharT, Traits >::good | ( | ) | const [inline, inherited] |
Fast error checking.
Definition at line 166 of file basic_ios.h.
Referenced by std::basic_ostream< CharT, Traits >::sentry::sentry(), and std::basic_istream< CharT, Traits >::sentry::sentry().
bool std::basic_ios< CharT, Traits >::eof | ( | ) | const [inline, inherited] |
Fast error checking.
Definition at line 176 of file basic_ios.h.
bool std::basic_ios< CharT, Traits >::fail | ( | ) | const [inline, inherited] |
Fast error checking.
Definition at line 187 of file basic_ios.h.
Referenced by std::basic_ios< char, Traits >::operator void *(), std::basic_ios< char, Traits >::operator!(), std::basic_istream< CharT, Traits >::seekg(), std::basic_ostream< CharT, Traits >::seekp(), std::basic_istream< CharT, Traits >::tellg(), and std::basic_ostream< CharT, Traits >::tellp().
bool std::basic_ios< CharT, Traits >::bad | ( | ) | const [inline, inherited] |
Fast error checking.
Definition at line 197 of file basic_ios.h.
iostate std::basic_ios< CharT, Traits >::exceptions | ( | ) | const [inline, inherited] |
Throwing exceptions on errors.
Definition at line 208 of file basic_ios.h.
Referenced by std::basic_ios< CharT, Traits >::clear(), and std::basic_ios< CharT, Traits >::copyfmt().
void std::basic_ios< CharT, Traits >::exceptions | ( | iostate | __except | ) | [inline, inherited] |
Throwing exceptions on errors.
except | The new exceptions mask. |
If the error flage is already set when the exceptions mask is added, the exception is immediately thrown. Try running the following under GCC 3.1 or later:
#include <iostream> #include <fstream> #include <exception> int main() { std::set_terminate (__gnu_cxx::__verbose_terminate_handler); std::ifstream f ("/etc/motd"); std::cerr << "Setting badbit\n"; f.setstate (std::ios_base::badbit); std::cerr << "Setting exception mask\n"; f.exceptions (std::ios_base::badbit); }
Definition at line 243 of file basic_ios.h.
basic_ostream<CharT, Traits>* std::basic_ios< CharT, Traits >::tie | ( | ) | const [inline, inherited] |
Fetches the current tied stream.
std::cin
is tied to std::cout
.
Definition at line 281 of file basic_ios.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), std::basic_ostream< CharT, Traits >::sentry::sentry(), and std::basic_istream< CharT, Traits >::sentry::sentry().
basic_ostream<CharT, Traits>* std::basic_ios< CharT, Traits >::tie | ( | basic_ostream< CharT, Traits > * | __tiestr | ) | [inline, inherited] |
Ties this stream to an output stream.
tiestr | The output stream. |
Definition at line 293 of file basic_ios.h.
basic_streambuf< CharT, Traits > * std::basic_ios< CharT, Traits >::rdbuf | ( | basic_streambuf< CharT, Traits > * | sb | ) | [inline, inherited] |
Changing the underlying buffer.
sb | The new stream buffer. |
Due to historical accidents which the LWG refuses to correct, the I/O library suffers from a design error: this function is hidden in derived classes by overrides of the zero-argument rdbuf()
, which is non-virtual for hysterical raisins. As a result, you must use explicit qualifications to access this function via any derived class. For example:
std::fstream foo; // or some other derived type std::streambuf* p = .....; foo.ios::rdbuf(p); // ios == basic_ios<char>
Definition at line 51 of file basic_ios.tcc.
References std::basic_ios< CharT, Traits >::clear().
basic_ios< CharT, Traits > & std::basic_ios< CharT, Traits >::copyfmt | ( | const basic_ios< CharT, Traits > & | __rhs | ) | [inline, inherited] |
Copies fields of __rhs into this.
__rhs | The source values for the copies. |
Definition at line 61 of file basic_ios.tcc.
References std::basic_ios< CharT, Traits >::exceptions(), std::basic_ios< CharT, Traits >::fill(), std::ios_base::flags(), std::ios_base::getloc(), std::ios_base::precision(), std::basic_ios< CharT, Traits >::tie(), and std::ios_base::width().
char_type std::basic_ios< CharT, Traits >::fill | ( | ) | const [inline, inherited] |
Retreives the "empty" character.
Definition at line 356 of file basic_ios.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), std::basic_ios< char, Traits >::fill(), and std::basic_ostream< CharT, Traits >::operator<<().
char_type std::basic_ios< CharT, Traits >::fill | ( | char_type | ch | ) | [inline, inherited] |
Sets a new "empty" character.
ch | The new character. |
Definition at line 376 of file basic_ios.h.
locale std::basic_ios< CharT, Traits >::imbue | ( | const locale & | __loc | ) | [inline, inherited] |
Moves to a new locale.
loc | The new locale. |
ios_base::imbue(loc)
, and if a stream buffer is associated with this stream, calls that buffer's pubimbue(loc)
.Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/22_locale/howto.html
Reimplemented from std::ios_base.
Definition at line 127 of file basic_ios.tcc.
References std::ios_base::getloc(), std::ios_base::imbue(), and std::basic_ios< CharT, Traits >::rdbuf().
Referenced by std::operator<<().
char std::basic_ios< CharT, Traits >::narrow | ( | char_type | c, | |
char | __dfault | |||
) | const [inline, inherited] |
Squeezes characters.
c | The character to narrow. | |
dfault | The character to narrow. |
char_type
to a character of char
, if possible.Returns the result of
Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/22_locale/howto.html
Definition at line 116 of file basic_ios.tcc.
CharT std::basic_ios< CharT, Traits >::widen | ( | char | c | ) | const [inline, inherited] |
Widens characters.
c | The character to widen. |
char
to a character of char_type
.Returns the result of
Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/22_locale/howto.html
Definition at line 121 of file basic_ios.tcc.
Referenced by std::endl(), std::basic_ios< char, Traits >::fill(), std::basic_istream< char >::get(), std::getline(), std::basic_istream< char >::getline(), and std::operator>>().
void std::basic_ios< CharT, Traits >::init | ( | basic_streambuf< CharT, Traits > * | sb | ) | [inline, protected, inherited] |
All setup is performed here.
This is called from the public constructor. It is not virtual and cannot be redefined.
Definition at line 139 of file basic_ios.tcc.
References std::ios_base::badbit, and std::ios_base::goodbit.
Referenced by std::basic_fstream< CharT, Traits >::basic_fstream(), std::basic_ifstream< CharT, Traits >::basic_ifstream(), std::basic_ios< char, Traits >::basic_ios(), std::basic_iostream< char >::basic_iostream(), std::basic_istream< char >::basic_istream(), std::basic_istringstream< CharT, Traits, Alloc >::basic_istringstream(), std::basic_ofstream< CharT, Traits >::basic_ofstream(), std::basic_ostream< char >::basic_ostream(), std::basic_ostringstream< CharT, Traits, Alloc >::basic_ostringstream(), and std::basic_stringstream< CharT, Traits, Alloc >::basic_stringstream().
void std::ios_base::register_callback | ( | event_callback | __fn, | |
int | index | |||
) | [inherited] |
Add the callback __fn with parameter index.
__fn | The function to add. | |
index | The integer to pass to the function when invoked. |
fmtflags std::ios_base::flags | ( | ) | const [inline, inherited] |
Access to format flags.
Definition at line 550 of file ios_base.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), std::num_get< CharT, InIter >::do_get(), std::num_put< CharT, OutIter >::do_put(), std::basic_ostream< CharT, Traits >::operator<<(), std::basic_ostream< char >::operator<<(), std::operator<<(), and std::basic_istream< CharT, Traits >::sentry::sentry().
Setting new format flags all at once.
fmtfl | The new flags to set. |
Definition at line 560 of file ios_base.h.
Setting new format flags.
fmtfl | Additional flags to set. |
Definition at line 576 of file ios_base.h.
Referenced by std::boolalpha(), std::dec(), std::fixed(), std::hex(), std::internal(), std::left(), std::oct(), std::right(), std::scientific(), std::showbase(), std::showpoint(), std::showpos(), std::skipws(), std::unitbuf(), and std::uppercase().
Setting new format flags.
fmtfl | Additional flags to set. | |
mask | The flags mask for fmtfl. |
&
mask. An example mask is ios_base::adjustfield
.
Definition at line 593 of file ios_base.h.
void std::ios_base::unsetf | ( | fmtflags | __mask | ) | [inline, inherited] |
Clearing format flags.
mask | The flags to unset. |
Definition at line 608 of file ios_base.h.
Referenced by std::noboolalpha(), std::noshowbase(), std::noshowpoint(), std::noshowpos(), std::noskipws(), std::nounitbuf(), and std::nouppercase().
streamsize std::ios_base::precision | ( | ) | const [inline, inherited] |
Flags access.
Definition at line 620 of file ios_base.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), and std::operator<<().
streamsize std::ios_base::precision | ( | streamsize | __prec | ) | [inline, inherited] |
Changing flags.
prec | The new precision value. |
Definition at line 628 of file ios_base.h.
streamsize std::ios_base::width | ( | ) | const [inline, inherited] |
Flags access.
Definition at line 642 of file ios_base.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), std::num_put< CharT, OutIter >::do_put(), and std::operator>>().
streamsize std::ios_base::width | ( | streamsize | __wide | ) | [inline, inherited] |
Changing flags.
wide | The new width value. |
Definition at line 650 of file ios_base.h.
bool std::ios_base::sync_with_stdio | ( | bool | sync = true |
) | [static, inherited] |
Interaction with the standard C I/O objects.
sync | Whether to synchronize or not. |
Definition at line 148 of file ios_init.cc.
References std::cerr, std::cin, std::clog, std::cout, std::ios_base::in, and std::ios_base::out.
locale std::ios_base::getloc | ( | ) | const [inline, inherited] |
Locale access.
imbue(loc)
has previously been called, then this function returns loc
. Otherwise, it returns a copy of std::locale()
, the global C++ locale.
Definition at line 692 of file ios_base.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), std::money_put< CharT, OutIter >::do_put(), std::basic_ios< CharT, Traits >::imbue(), std::operator>>(), and std::ws().
const locale& std::ios_base::M_getloc | ( | ) | const [inline, inherited] |
Locale access.
Definition at line 702 of file ios_base.h.
int std::ios_base::xalloc | ( | ) | throw () [static, inherited] |
Access to unique indices.
The implementation maintains a static variable that is incremented and returned on each invocation. xalloc is guaranteed to return an index that is safe to use in the iword and pword arrays.
long& std::ios_base::iword | ( | int | __ix | ) | [inline, inherited] |
Access to integer array.
__ix | Index into the array. |
The implementation reserves several indices. You should use xalloc to obtain an index that is safe to use. Also note that since the array can grow dynamically, it is not safe to hold onto the reference.
Definition at line 736 of file ios_base.h.
void*& std::ios_base::pword | ( | int | __ix | ) | [inline, inherited] |
Access to void pointer array.
__ix | Index into the array. |
The implementation reserves several indices. You should use xalloc to obtain an index that is safe to use. Also note that since the array can grow dynamically, it is not safe to hold onto the reference.
Definition at line 757 of file ios_base.h.
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | __ostream_type &(*)(__ostream_type &) | __pf | ) | [inline, inherited] |
Interface for manipulators.
Manuipulators such as std::endl
and std::hex
use these functions in constructs like "std::cout << std::endl". For more information, see the iomanip header.
Definition at line 62 of file ostream.tcc.
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | __ios_type &(*)(__ios_type &) | __pf | ) | [inline, inherited] |
Interface for manipulators.
Manuipulators such as std::endl
and std::hex
use these functions in constructs like "std::cout << std::endl". For more information, see the iomanip header.
Definition at line 73 of file ostream.tcc.
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | ios_base &(*)(ios_base &) | __pf | ) | [inline, inherited] |
Interface for manipulators.
Manuipulators such as std::endl
and std::hex
use these functions in constructs like "std::cout << std::endl". For more information, see the iomanip header.
Definition at line 85 of file ostream.tcc.
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | long | n | ) | [inline, inherited] |
Basic arithmetic inserters.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to perform numeric formatting.
Definition at line 120 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::basefield, std::basic_ios< CharT, Traits >::fill(), std::ios_base::flags(), std::ios_base::goodbit, std::ios_base::hex, std::ios_base::oct, and std::basic_ios< CharT, Traits >::setstate().
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | unsigned long | n | ) | [inline, inherited] |
Basic arithmetic inserters.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to perform numeric formatting.
Definition at line 154 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | bool | n | ) | [inline, inherited] |
Basic arithmetic inserters.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to perform numeric formatting.
Definition at line 97 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
__ostream_type& std::basic_ostream< CharT, Traits >::operator<< | ( | short | n | ) | [inline, inherited] |
__ostream_type& std::basic_ostream< CharT, Traits >::operator<< | ( | unsigned short | n | ) | [inline, inherited] |
__ostream_type& std::basic_ostream< CharT, Traits >::operator<< | ( | int | n | ) | [inline, inherited] |
__ostream_type& std::basic_ostream< CharT, Traits >::operator<< | ( | unsigned int | n | ) | [inline, inherited] |
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | double | __f | ) | [inline, inherited] |
Basic arithmetic inserters.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to perform numeric formatting.
Definition at line 237 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
__ostream_type& std::basic_ostream< CharT, Traits >::operator<< | ( | float | __f | ) | [inline, inherited] |
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | long double | __f | ) | [inline, inherited] |
Basic arithmetic inserters.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to perform numeric formatting.
Definition at line 260 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | const void * | __p | ) | [inline, inherited] |
Basic arithmetic inserters.
A | variable of builtin type. |
*this
if successfulnum_get
facet) to perform numeric formatting.
Definition at line 283 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, and std::basic_ios< CharT, Traits >::setstate().
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::operator<< | ( | streambuf_type * | sb | ) | [inline, inherited] |
Extracting from another streambuf.
sb | A pointer to a streambuf |
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into *this
until one of the following occurs:
If the function inserts no characters, failbit is set.
Definition at line 306 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::failbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::put | ( | char_type | c | ) | [inline, inherited] |
Simple insertion.
c | The character to insert. |
Definition at line 330 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
Referenced by std::endl(), and std::ends().
void std::basic_ostream< CharT, Traits >::M_write | ( | const char_type * | s, | |
streamsize | n | |||
) | [inline, inherited] |
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::write | ( | const char_type * | s, | |
streamsize | n | |||
) | [inline, inherited] |
Character string insertion.
s | The array to insert. | |
n | Maximum number of characters to insert. |
Definition at line 359 of file ostream.tcc.
References std::ios_base::badbit.
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::flush | ( | ) | [inline, inherited] |
Synchronizing the stream buffer.
rdbuf()
is a null pointer, changes nothing.
Otherwise, calls rdbuf()->pubsync()
, and if that returns -1, sets badbit.
Definition at line 382 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::goodbit, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
Referenced by std::flush().
basic_ostream< CharT, Traits >::pos_type std::basic_ostream< CharT, Traits >::tellp | ( | ) | [inline, inherited] |
Getting the current write position.
fail()
is not false, returns pos_type
(-1) to indicate failure. Otherwise returns rdbuf()->pubseekoff(0,cur,out)
.
Definition at line 403 of file ostream.tcc.
References std::ios_base::badbit, std::ios_base::cur, std::basic_ios< CharT, Traits >::fail(), std::ios_base::out, and std::basic_ios< CharT, Traits >::rdbuf().
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::seekp | ( | pos_type | position | ) | [inline, inherited] |
Changing the current write position.
pos | A file position object. |
fail()
is not true, calls rdbuf()->pubseekpos(pos)
. If that function fails, sets failbit.
Definition at line 419 of file ostream.tcc.
References std::ios_base::badbit, std::basic_ios< CharT, Traits >::fail(), std::ios_base::failbit, std::ios_base::goodbit, std::ios_base::out, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
basic_ostream< CharT, Traits > & std::basic_ostream< CharT, Traits >::seekp | ( | off_type | __off, | |
ios_base::seekdir | __dir | |||
) | [inline, inherited] |
Changing the current write position.
off | A file offset object. | |
dir | The direction in which to seek. |
fail()
is not true, calls rdbuf()->pubseekoff(off,dir)
. If that function fails, sets failbit.
Definition at line 446 of file ostream.tcc.
References std::ios_base::badbit, std::basic_ios< CharT, Traits >::fail(), std::ios_base::failbit, std::ios_base::goodbit, std::ios_base::out, std::basic_ios< CharT, Traits >::rdbuf(), and std::basic_ios< CharT, Traits >::setstate().
const ios_base::fmtflags std::ios_base::boolalpha [static, inherited] |
Insert/extract bool
in alphabetic rather than numeric format.
Definition at line 256 of file ios_base.h.
Referenced by std::boolalpha(), std::num_get< CharT, InIter >::do_get(), std::num_put< CharT, OutIter >::do_put(), and std::noboolalpha().
const ios_base::fmtflags std::ios_base::dec [static, inherited] |
Converts integer input or generates integer output in decimal base.
Definition at line 259 of file ios_base.h.
Referenced by std::dec().
const ios_base::fmtflags std::ios_base::fixed [static, inherited] |
Generate floating-point output in fixed-point notation.
Definition at line 262 of file ios_base.h.
Referenced by std::fixed().
const ios_base::fmtflags std::ios_base::hex [static, inherited] |
Converts integer input or generates integer output in hexadecimal base.
Definition at line 265 of file ios_base.h.
Referenced by std::num_get< CharT, InIter >::do_get(), std::num_put< CharT, OutIter >::do_put(), std::hex(), std::basic_ostream< CharT, Traits >::operator<<(), and std::basic_ostream< char >::operator<<().
const ios_base::fmtflags std::ios_base::internal [static, inherited] |
Adds fill characters at a designated internal point in certain generated output, or identical to right
if no such point is designated.
Definition at line 270 of file ios_base.h.
Referenced by std::num_put< CharT, OutIter >::do_put(), and std::internal().
const ios_base::fmtflags std::ios_base::left [static, inherited] |
Adds fill characters on the right (final positions) of certain generated output. (I.e., the thing you print is flush left.).
Definition at line 274 of file ios_base.h.
Referenced by std::left().
const ios_base::fmtflags std::ios_base::oct [static, inherited] |
Converts integer input or generates integer output in octal base.
Definition at line 277 of file ios_base.h.
Referenced by std::oct(), std::basic_ostream< CharT, Traits >::operator<<(), and std::basic_ostream< char >::operator<<().
const ios_base::fmtflags std::ios_base::right [static, inherited] |
Adds fill characters on the left (initial positions) of certain generated output. (I.e., the thing you print is flush right.).
Definition at line 281 of file ios_base.h.
Referenced by std::right().
const ios_base::fmtflags std::ios_base::scientific [static, inherited] |
Generates floating-point output in scientific notation.
Definition at line 284 of file ios_base.h.
Referenced by std::scientific().
const ios_base::fmtflags std::ios_base::showbase [static, inherited] |
Generates a prefix indicating the numeric base of generated integer output.
Definition at line 288 of file ios_base.h.
Referenced by std::num_put< CharT, OutIter >::do_put(), std::noshowbase(), and std::showbase().
const ios_base::fmtflags std::ios_base::showpoint [static, inherited] |
Generates a decimal-point character unconditionally in generated floating-point output.
Definition at line 292 of file ios_base.h.
Referenced by std::noshowpoint(), and std::showpoint().
const ios_base::fmtflags std::ios_base::showpos [static, inherited] |
Generates a + sign in non-negative generated numeric output.
Definition at line 295 of file ios_base.h.
Referenced by std::noshowpos(), and std::showpos().
const ios_base::fmtflags std::ios_base::skipws [static, inherited] |
Skips leading white space before certain input operations.
Definition at line 298 of file ios_base.h.
Referenced by std::noskipws(), std::basic_istream< CharT, Traits >::sentry::sentry(), and std::skipws().
const ios_base::fmtflags std::ios_base::unitbuf [static, inherited] |
Flushes output after each output operation.
Definition at line 301 of file ios_base.h.
Referenced by std::nounitbuf(), std::unitbuf(), and std::basic_ostream< CharT, Traits >::sentry::~sentry().
const ios_base::fmtflags std::ios_base::uppercase [static, inherited] |
Replaces certain lowercase letters with their uppercase equivalents in generated output.
Definition at line 305 of file ios_base.h.
Referenced by std::nouppercase(), and std::uppercase().
const ios_base::fmtflags std::ios_base::adjustfield [static, inherited] |
A mask of left|right|internal. Useful for the 2-arg form of setf
.
Definition at line 308 of file ios_base.h.
Referenced by std::internal(), std::left(), and std::right().
const ios_base::fmtflags std::ios_base::basefield [static, inherited] |
A mask of dec|oct|hex. Useful for the 2-arg form of setf
.
Definition at line 311 of file ios_base.h.
Referenced by std::dec(), std::num_get< CharT, InIter >::do_get(), std::hex(), std::oct(), std::basic_ostream< CharT, Traits >::operator<<(), and std::basic_ostream< char >::operator<<().
const ios_base::fmtflags std::ios_base::floatfield [static, inherited] |
A mask of scientific|fixed. Useful for the 2-arg form of setf
.
Definition at line 314 of file ios_base.h.
Referenced by std::fixed(), and std::scientific().
const ios_base::iostate std::ios_base::badbit [static, inherited] |
Indicates a loss of integrity in an input or output sequence (such as an irrecoverable read error from a file).
Definition at line 332 of file ios_base.h.
Referenced by std::basic_ios< char, Traits >::bad(), std::basic_ios< CharT, Traits >::clear(), std::basic_ios< char, Traits >::fail(), std::basic_ostream< CharT, Traits >::flush(), std::basic_istream< CharT, Traits >::get(), std::getline(), std::basic_istream< CharT, Traits >::getline(), std::basic_istream< CharT, Traits >::ignore(), std::basic_ios< CharT, Traits >::init(), std::basic_ostream< char >::M_write(), std::operator<<(), std::basic_ostream< CharT, Traits >::operator<<(), std::basic_istream< CharT, Traits >::operator>>(), std::operator>>(), std::basic_istream< CharT, Traits >::peek(), std::basic_ostream< CharT, Traits >::put(), std::basic_istream< CharT, Traits >::putback(), std::basic_istream< CharT, Traits >::read(), std::basic_istream< CharT, Traits >::readsome(), std::basic_istream< CharT, Traits >::seekg(), std::basic_ostream< CharT, Traits >::seekp(), std::basic_istream< CharT, Traits >::sync(), std::basic_istream< CharT, Traits >::tellg(), std::basic_ostream< CharT, Traits >::tellp(), std::basic_istream< CharT, Traits >::unget(), std::basic_ostream< CharT, Traits >::write(), and std::basic_ostream< CharT, Traits >::sentry::~sentry().
const ios_base::iostate std::ios_base::eofbit [static, inherited] |
Indicates that an input operation reached the end of an input sequence.
Definition at line 335 of file ios_base.h.
Referenced by std::num_get< CharT, InIter >::do_get(), std::time_get< CharT, InIter >::do_get_date(), std::time_get< CharT, InIter >::do_get_monthname(), std::time_get< CharT, InIter >::do_get_time(), std::time_get< CharT, InIter >::do_get_weekday(), std::time_get< CharT, InIter >::do_get_year(), std::basic_ios< char, Traits >::eof(), std::basic_istream< CharT, Traits >::get(), std::getline(), std::basic_istream< CharT, Traits >::getline(), std::basic_istream< CharT, Traits >::ignore(), std::operator>>(), std::basic_istream< CharT, Traits >::peek(), std::basic_istream< CharT, Traits >::read(), std::basic_istream< CharT, Traits >::readsome(), std::basic_istream< CharT, Traits >::sentry::sentry(), and std::ws().
const ios_base::iostate std::ios_base::failbit [static, inherited] |
Indicates that an input operation failed to read the expected characters, or that an output operation failed to generate the desired characters.
Definition at line 340 of file ios_base.h.
Referenced by std::basic_fstream< CharT, Traits >::close(), std::basic_ofstream< CharT, Traits >::close(), std::basic_ifstream< CharT, Traits >::close(), std::basic_ios< char, Traits >::fail(), std::basic_istream< CharT, Traits >::get(), std::getline(), std::basic_istream< CharT, Traits >::getline(), std::basic_fstream< CharT, Traits >::open(), std::basic_ofstream< CharT, Traits >::open(), std::basic_ifstream< CharT, Traits >::open(), std::basic_ostream< CharT, Traits >::operator<<(), std::basic_istream< CharT, Traits >::operator>>(), std::operator>>(), std::basic_istream< CharT, Traits >::read(), std::basic_istream< CharT, Traits >::seekg(), std::basic_ostream< CharT, Traits >::seekp(), std::basic_ostream< CharT, Traits >::sentry::sentry(), and std::basic_istream< CharT, Traits >::sentry::sentry().
const ios_base::iostate std::ios_base::goodbit [static, inherited] |
Indicates all is well.
Definition at line 343 of file ios_base.h.
Referenced by std::basic_ostream< CharT, Traits >::flush(), std::basic_istream< CharT, Traits >::get(), std::getline(), std::basic_istream< CharT, Traits >::getline(), std::basic_istream< CharT, Traits >::ignore(), std::basic_ios< CharT, Traits >::init(), std::basic_ostream< CharT, Traits >::operator<<(), std::basic_istream< CharT, Traits >::operator>>(), std::operator>>(), std::basic_istream< CharT, Traits >::peek(), std::basic_ostream< CharT, Traits >::put(), std::basic_istream< CharT, Traits >::putback(), std::basic_istream< CharT, Traits >::read(), std::basic_istream< CharT, Traits >::readsome(), std::basic_istream< CharT, Traits >::seekg(), std::basic_ostream< CharT, Traits >::seekp(), std::basic_istream< CharT, Traits >::sentry::sentry(), std::basic_istream< CharT, Traits >::sync(), and std::basic_istream< CharT, Traits >::unget().
const ios_base::openmode std::ios_base::app [static, inherited] |
const ios_base::openmode std::ios_base::ate [static, inherited] |
Open and seek to end immediately after opening.
Definition at line 365 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::open().
const ios_base::openmode std::ios_base::binary [static, inherited] |
Perform input and output in binary mode (as opposed to text mode). This is probably not what you think it is; see http://gcc.gnu.org/onlinedocs/libstdc++/27_io/howto.html#3 and http://gcc.gnu.org/onlinedocs/libstdc++/27_io/howto.html#7 for more.
Definition at line 371 of file ios_base.h.
const ios_base::openmode std::ios_base::in [static, inherited] |
Open for input. Default for ifstream
and fstream.
Definition at line 374 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::pbackfail(), std::basic_istream< CharT, Traits >::seekg(), std::basic_stringbuf< CharT, Traits, Alloc >::seekoff(), std::basic_stringbuf< CharT, Traits, Alloc >::seekpos(), std::basic_filebuf< CharT, Traits >::showmanyc(), std::ios_base::sync_with_stdio(), std::basic_istream< CharT, Traits >::tellg(), std::basic_stringbuf< CharT, Traits, Alloc >::underflow(), std::basic_filebuf< CharT, Traits >::underflow(), and std::basic_filebuf< CharT, Traits >::xsgetn().
const ios_base::openmode std::ios_base::out [static, inherited] |
Open for output. Default for ofstream
and fstream.
Definition at line 377 of file ios_base.h.
Referenced by std::basic_stringbuf< CharT, Traits, Alloc >::overflow(), std::basic_filebuf< CharT, Traits >::overflow(), std::basic_stringbuf< CharT, Traits, Alloc >::seekoff(), std::basic_ostream< CharT, Traits >::seekp(), std::basic_stringbuf< CharT, Traits, Alloc >::seekpos(), std::ios_base::sync_with_stdio(), std::basic_ostream< CharT, Traits >::tellp(), and std::basic_filebuf< CharT, Traits >::xsputn().
const ios_base::openmode std::ios_base::trunc [static, inherited] |
const ios_base::seekdir std::ios_base::beg [static, inherited] |
Request a seek relative to the beginning of the stream.
Definition at line 395 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::seekpos().
const ios_base::seekdir std::ios_base::cur [static, inherited] |
Request a seek relative to the current position within the sequence.
Definition at line 398 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::imbue(), std::basic_filebuf< CharT, Traits >::pbackfail(), std::basic_stringbuf< CharT, Traits, Alloc >::seekoff(), std::basic_filebuf< CharT, Traits >::seekoff(), std::basic_istream< CharT, Traits >::tellg(), and std::basic_ostream< CharT, Traits >::tellp().
const ios_base::seekdir std::ios_base::end [static, inherited] |
Request a seek relative to the current end of the sequence.
Definition at line 401 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::open(), and std::basic_stringbuf< CharT, Traits, Alloc >::seekoff().