Definition at line 57 of file ostream.
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.
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.
|
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 basic_ios. Reimplemented in basic_ofstream, basic_fstream, basic_iostream, basic_ostringstream, and basic_stringstream. |
|
The type of an event callback function.
Definition at line 435 of file ios_base.h. |
|
This is a bitmask type.
Definition at line 253 of file ios_base.h. |
|
This is a bitmask type.
Definition at line 328 of file ios_base.h. |
|
This is a bitmask type.
Definition at line 359 of file ios_base.h. |
|
This is an enumerated type.
Definition at line 392 of file ios_base.h. |
|
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 418 of file ios_base.h. |
|
Base constructor. This ctor is almost never called by the user directly, rather from derived classes' initialization lists, which pass a pointer to their own stream buffer. Definition at line 104 of file ostream. References basic_ios::init(). |
|
Base destructor. This does very little apart from providing a virtual base dtor. |
|
Locale access.
Definition at line 700 of file ios_base.h. Referenced by money_get::do_get(), num_get::do_get(), time_get::do_get_date(), time_get::do_get_monthname(), time_get::do_get_time(), time_get::do_get_weekday(), time_get::do_get_year(), time_put::do_put(), num_put::do_put(), and time_put::put(). |
|
Fast error checking.
Definition at line 197 of file basic_ios.h. References ios_base::badbit. |
|
[Re]sets the error state.
Definition at line 44 of file basic_ios.tcc. References ios_base::badbit, and basic_ios::rdstate(). Referenced by basic_ios::exceptions(), basic_fstream::open(), basic_ofstream::open(), basic_ifstream::open(), basic_ios::rdbuf(), and basic_ios::setstate(). |
|
Copies fields of __rhs into this.
Definition at line 66 of file basic_ios.tcc. References ios_base::_M_callbacks, ios_base::_M_word, ios_base::_M_word_size, basic_ios::exceptions(), basic_ios::fill(), ios_base::flags(), ios_base::getloc(), ios_base::precision(), basic_ios::tie(), and ios_base::width(). |
|
Fast error checking.
Definition at line 176 of file basic_ios.h. References ios_base::eofbit. |
|
Throwing exceptions on errors.
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. References basic_ios::clear(). |
|
Throwing exceptions on errors.
Definition at line 208 of file basic_ios.h. Referenced by basic_ios::copyfmt(). |
|
Fast error checking.
Definition at line 187 of file basic_ios.h. References ios_base::badbit, and ios_base::failbit. Referenced by basic_ios::operator void *(). |
|
Sets a new "empty" character.
Definition at line 376 of file basic_ios.h. References basic_ios::fill(). |
|
Retreives the "empty" character.
Definition at line 356 of file basic_ios.h. References basic_ios::widen(). Referenced by basic_ios::copyfmt(), basic_ios::fill(), and basic_ostream::operator<<(). |
|
Setting new format flags all at once.
Definition at line 558 of file ios_base.h. |
|
Access to format flags.
Definition at line 548 of file ios_base.h. Referenced by basic_ios::copyfmt(), num_get::do_get(), num_put::do_put(), and basic_ostream::operator<<(). |
|
Synchronizing the stream buffer.
rdbuf() is a null pointer, changes nothing.
Otherwise, calls Definition at line 387 of file ostream.tcc. References ios_base::badbit, ios_base::goodbit, basic_ios::rdbuf(), and basic_ios::setstate(). Referenced by std::flush(). |
|
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 690 of file ios_base.h. Referenced by basic_ios::copyfmt(), and money_put::do_put(). |
|
Fast error checking.
Definition at line 166 of file basic_ios.h. References basic_ios::rdstate(). |
|
Moves to a 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 ios_base. Definition at line 127 of file basic_ios.tcc. References ios_base::imbue(), and basic_ios::rdbuf(). |
|
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 ios_base::badbit, and ios_base::goodbit. Referenced by basic_fstream::basic_fstream(), basic_ifstream::basic_ifstream(), basic_ios::basic_ios(), basic_iostream::basic_iostream(), basic_istream::basic_istream(), basic_istringstream::basic_istringstream(), basic_ofstream::basic_ofstream(), basic_ostream::basic_ostream(), basic_ostringstream::basic_ostringstream(), and basic_stringstream::basic_stringstream(). |
|
Access to integer 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 734 of file ios_base.h. |
|
Squeezes characters.
char_type to a character of char , if possible.Returns the result of std::use_facet<ctype<char_type> >(getloc()).narrow(c,dfault) Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/22_locale/howto.html Definition at line 116 of file basic_ios.tcc. |
|
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. References basic_ios::fail(). |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 311 of file ostream.tcc. References ios_base::badbit, ios_base::failbit, ios_base::goodbit, and basic_ios::setstate(). |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 288 of file ostream.tcc. References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate(). |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 265 of file ostream.tcc. References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate(). |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 242 of file ostream.tcc. References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate(). |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 218 of file ostream.tcc. References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate(). |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 183 of file ostream.tcc. References ios_base::badbit, ios_base::basefield, basic_ios::fill(), ios_base::flags(), ios_base::goodbit, ios_base::hex, ios_base::oct, num_put::put(), and basic_ios::setstate(). |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 191 of file ostream. References ios_base::basefield, ios_base::flags(), ios_base::hex, and ios_base::oct. |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 176 of file ostream. References ios_base::basefield, ios_base::flags(), ios_base::hex, and ios_base::oct. |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 102 of file ostream.tcc. References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate(). |
|
Extracting from another streambuf.
If sb is NULL, the stream will set failbit in its error state.
Characters are extracted from sb and inserted into
If the function inserts no characters, failbit is set. Definition at line 159 of file ostream.tcc. References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate(). |
|
Basic arithmetic inserters.
num_get facet) to perform numeric formatting.
Definition at line 125 of file ostream.tcc. References ios_base::badbit, ios_base::basefield, basic_ios::fill(), ios_base::flags(), ios_base::goodbit, ios_base::hex, ios_base::oct, num_put::put(), and basic_ios::setstate(). |
|
Interface for manipulators.
Manuipulators such as Definition at line 67 of file ostream.tcc. |
|
Changing flags.
Definition at line 626 of file ios_base.h. |
|
Flags access.
Definition at line 618 of file ios_base.h. Referenced by basic_ios::copyfmt(). |
|
Simple insertion.
Definition at line 335 of file ostream.tcc. References ios_base::badbit, ios_base::goodbit, basic_ios::rdbuf(), and basic_ios::setstate(). Referenced by std::ends(). |
|
Access to void pointer 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 755 of file ios_base.h. |
|
Changing the underlying 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
std::fstream foo; // or some other derived type std::streambuf* p = .....; foo.ios::rdbuf(p); // ios == basic_ios<char> Definition at line 56 of file basic_ios.tcc. References basic_ios::clear(). |
|
Accessing the underlying buffer.
Reimplemented in basic_ifstream, basic_ofstream, basic_fstream, basic_istringstream, basic_ostringstream, and basic_stringstream. Definition at line 307 of file basic_ios.h. Referenced by basic_ostream::flush(), basic_istream::get(), basic_istream::getline(), basic_istream::ignore(), basic_ios::imbue(), std::operator>>(), basic_istream::peek(), basic_ostream::put(), basic_istream::putback(), basic_istream::read(), basic_istream::readsome(), basic_istream::seekg(), basic_ostream::seekp(), basic_istream::sync(), basic_istream::tellg(), basic_ostream::tellp(), and basic_istream::unget(). |
|
Returns the error state of the stream buffer.
Definition at line 123 of file basic_ios.h. Referenced by basic_ios::clear(), and basic_ios::good(). |
|
Add the callback __fn with parameter __index.
|
|
Changing the current write position.
fail() is not true, calls rdbuf()->pubseekoff(off,dir) . If that function fails, sets failbit.
Definition at line 451 of file ostream.tcc. References ios_base::badbit, ios_base::failbit, ios_base::goodbit, ios_base::out, basic_ios::rdbuf(), and basic_ios::setstate(). |
|
Changing the current write position.
fail() is not true, calls rdbuf()->pubseekpos(pos) . If that function fails, sets failbit.
Definition at line 424 of file ostream.tcc. References ios_base::badbit, ios_base::failbit, ios_base::goodbit, ios_base::out, basic_ios::rdbuf(), and basic_ios::setstate(). |
|
Setting new format flags.
& mask. An example mask is ios_base::adjustfield .
Definition at line 591 of file ios_base.h. |
|
Setting new format flags.
Definition at line 574 of file ios_base.h. Referenced by std::boolalpha(). |
|
Sets additional flags in the error state.
Definition at line 143 of file basic_ios.h. References basic_ios::clear(). Referenced by basic_fstream::close(), basic_ofstream::close(), basic_ifstream::close(), basic_ostream::flush(), basic_istream::get(), basic_istream::getline(), basic_istream::ignore(), basic_fstream::open(), basic_ofstream::open(), basic_ifstream::open(), basic_ostream::operator<<(), std::operator>>(), basic_istream::operator>>(), basic_istream::peek(), basic_ostream::put(), basic_istream::putback(), basic_istream::read(), basic_istream::readsome(), basic_istream::seekg(), basic_ostream::seekp(), basic_istream::sync(), and basic_istream::unget(). |
|
Interaction with the standard C I/O objects.
|
|
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 408 of file ostream.tcc. References ios_base::badbit, ios_base::cur, ios_base::out, and basic_ios::rdbuf(). |
|
Ties this stream to an output stream.
Definition at line 293 of file basic_ios.h. |
|
Fetches the current tied stream.
std::cin is tied to std::cout .
Definition at line 281 of file basic_ios.h. Referenced by basic_ios::copyfmt(). |
|
Clearing format flags.
Definition at line 606 of file ios_base.h. |
|
Widens characters.
char to a character of char_type .Returns the result of std::use_facet<ctype<char_type> >(getloc()).widen(c) 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 basic_ios::fill(). |
|
Changing flags.
Definition at line 648 of file ios_base.h. |
|
Flags access.
Definition at line 640 of file ios_base.h. Referenced by basic_ios::copyfmt(), and num_put::do_put(). |
|
Character string insertion.
|
|
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. |
|
A mask of left|right|internal. Useful for the 2-arg form of
Definition at line 308 of file ios_base.h. Referenced by std::internal(), std::left(), and std::right(). |
|
Seek to end before each write.
Definition at line 362 of file ios_base.h. |
|
Open and seek to end immediately after opening.
Definition at line 365 of file ios_base.h. Referenced by basic_filebuf::open(). |
|
as an irrecoverable read error from a file).
Definition at line 332 of file ios_base.h. Referenced by basic_ios::bad(), basic_ios::clear(), basic_ios::fail(), basic_ostream::flush(), basic_istream::get(), std::getline(), basic_istream::getline(), basic_istream::ignore(), basic_ios::init(), std::operator<<(), basic_ostream::operator<<(), basic_istream::operator>>(), std::operator>>(), basic_istream::peek(), basic_ostream::put(), basic_istream::putback(), basic_istream::read(), basic_istream::readsome(), basic_istream::seekg(), basic_ostream::seekp(), basic_istream::sync(), basic_istream::tellg(), basic_ostream::tellp(), and basic_istream::unget(). |
|
A mask of dec|oct|hex. Useful for the 2-arg form of
Definition at line 311 of file ios_base.h. Referenced by std::dec(), std::hex(), std::oct(), and basic_ostream::operator<<(). |
|
Request a seek relative to the beginning of the stream.
Definition at line 395 of file ios_base.h. Referenced by basic_filebuf::seekpos(). |
|
http://gcc.gnu.org/onlinedocs/libstdc++/27_io/howto.html#7 for more.
Definition at line 371 of file ios_base.h. Referenced by basic_filebuf::showmanyc(). |
|
Insert/extract
Definition at line 256 of file ios_base.h. Referenced by std::boolalpha(), num_get::do_get(), num_put::do_put(), and std::noboolalpha(). |
|
Request a seek relative to the current position within the sequence.
Definition at line 398 of file ios_base.h. Referenced by basic_filebuf::imbue(), basic_filebuf::pbackfail(), basic_stringbuf::seekoff(), basic_filebuf::seekoff(), basic_istream::tellg(), and basic_ostream::tellp(). |
|
Converts integer input or generates integer output in decimal base.
Definition at line 259 of file ios_base.h. Referenced by std::dec(). |
|
Request a seek relative to the current end of the sequence.
Definition at line 401 of file ios_base.h. Referenced by basic_filebuf::open(), and basic_stringbuf::seekoff(). |
|
Indicates that an input operation reached the end of an input sequence.
Definition at line 335 of file ios_base.h. Referenced by num_get::do_get(), time_get::do_get_date(), time_get::do_get_monthname(), time_get::do_get_time(), time_get::do_get_weekday(), time_get::do_get_year(), basic_ios::eof(), basic_istream::get(), std::getline(), basic_istream::getline(), basic_istream::ignore(), std::operator>>(), basic_istream::peek(), basic_istream::read(), basic_istream::readsome(), and std::ws(). |
|
desired characters.
Definition at line 340 of file ios_base.h. Referenced by basic_fstream::close(), basic_ofstream::close(), basic_ifstream::close(), basic_ios::fail(), basic_istream::get(), std::getline(), basic_istream::getline(), basic_fstream::open(), basic_ofstream::open(), basic_ifstream::open(), basic_ostream::operator<<(), basic_istream::operator>>(), std::operator>>(), basic_istream::read(), basic_istream::seekg(), and basic_ostream::seekp(). |
|
Generate floating-point output in fixed-point notation.
Definition at line 262 of file ios_base.h. Referenced by std::fixed(). |
|
A mask of scientific|fixed. Useful for the 2-arg form of
Definition at line 314 of file ios_base.h. Referenced by std::fixed(), and std::scientific(). |
|
Indicates all is well.
Definition at line 343 of file ios_base.h. Referenced by basic_ostream::flush(), basic_istream::get(), std::getline(), basic_istream::getline(), basic_istream::ignore(), basic_ios::init(), basic_ostream::operator<<(), basic_istream::operator>>(), std::operator>>(), basic_istream::peek(), basic_ostream::put(), basic_istream::putback(), basic_istream::read(), basic_istream::readsome(), basic_istream::seekg(), basic_ostream::seekp(), basic_istream::sync(), and basic_istream::unget(). |
|
Converts integer input or generates integer output in hexadecimal base.
Definition at line 265 of file ios_base.h. Referenced by std::hex(), and basic_ostream::operator<<(). |
|
Open for input. Default for
Definition at line 374 of file ios_base.h. Referenced by basic_filebuf::pbackfail(), basic_istream::seekg(), basic_stringbuf::seekoff(), basic_stringbuf::seekpos(), basic_filebuf::showmanyc(), basic_istream::tellg(), basic_stringbuf::underflow(), and basic_filebuf::underflow(). |
|
designated.
Definition at line 270 of file ios_base.h. Referenced by std::internal(). |
|
generated output. (I.e., the thing you print is flush left.)
Definition at line 274 of file ios_base.h. Referenced by std::left(). |
|
Converts integer input or generates integer output in octal base.
Definition at line 277 of file ios_base.h. Referenced by std::oct(), and basic_ostream::operator<<(). |
|
Open for output. Default for
Definition at line 377 of file ios_base.h. Referenced by basic_stringbuf::overflow(), basic_filebuf::overflow(), basic_stringbuf::pbackfail(), basic_stringbuf::seekoff(), basic_ostream::seekp(), basic_stringbuf::seekpos(), and basic_ostream::tellp(). |
|
generated output. (I.e., the thing you print is flush right.)
Definition at line 281 of file ios_base.h. Referenced by std::right(). |
|
Generates floating-point output in scientific notation.
Definition at line 284 of file ios_base.h. Referenced by std::scientific(). |
|
output.
Definition at line 288 of file ios_base.h. Referenced by std::noshowbase(), and std::showbase(). |
|
floating-point output.
Definition at line 292 of file ios_base.h. Referenced by std::noshowpoint(), and std::showpoint(). |
|
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(). |
|
Skips leading white space before certain input operations.
Definition at line 298 of file ios_base.h. Referenced by std::noskipws(), and std::skipws(). |
|
Open for input. Default for
Definition at line 380 of file ios_base.h. |
|
Flushes output after each output operation.
Definition at line 301 of file ios_base.h. Referenced by std::nounitbuf(), and std::unitbuf(). |
|
in generated output.
Definition at line 305 of file ios_base.h. Referenced by std::nouppercase(), and std::uppercase(). |