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.
sb
.
Definition at line 374 of file sstream.
typedef _CharT 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 basic_ostream.
typedef void(* 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. |
typedef _Ios_Fmtflags fmtflags [inherited] |
This is a bitmask type.
"_Ios_Fmtflags"
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 traits_type::int_type 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 basic_ostream.
typedef _Ios_Iostate iostate [inherited] |
This is a bitmask type.
"_Ios_Iostate"
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 traits_type::off_type 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 basic_ostream.
typedef _Ios_Openmode openmode [inherited] |
This is a bitmask type.
"_Ios_Openmode"
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 traits_type::pos_type 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 basic_ostream.
typedef _Ios_Seekdir seekdir [inherited] |
This is an enumerated type.
"_Ios_Seekdir"
is implementation-defined. Defined values of type seekdir are:
SEEK_CUR
in the C standard library.SEEK_END
in the C standard library. Definition at line 392 of file ios_base.h.
typedef _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 basic_ostream.
enum 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 418 of file ios_base.h.
basic_ostringstream | ( | ios_base::openmode | __mode = ios_base::out |
) | [inline, explicit] |
Default constructor starts with an empty string buffer.
mode | Whether the buffer can read, or write, or both. |
ios_base::out
is automatically included in mode.
Initializes sb
using mode|out
, and passes &sb
to the base class initializer. Does not allocate any buffer.
Definition at line 412 of file sstream.
References basic_ios::init().
basic_ostringstream | ( | const __string_type & | __str, | |
ios_base::openmode | __mode = ios_base::out | |||
) | [inline, explicit] |
Starts with an existing string buffer.
str | A string to copy as a starting buffer. | |
mode | Whether the buffer can read, or write, or both. |
ios_base::out
is automatically included in mode.
Initializes sb
using str and mode|out
, and passes &sb
to the base class initializer.
Definition at line 432 of file sstream.
References basic_ios::init().
~basic_ostringstream | ( | ) | [inline] |
const locale& _M_getloc | ( | ) | const [inline, inherited] |
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().
void _M_write | ( | const char_type * | __s, | |
streamsize | __n | |||
) | [inline, inherited] |
Simple insertion.
c | The character to insert. |
Definition at line 266 of file ostream.
References ios_base::badbit, basic_ios::rdbuf(), and basic_ios::setstate().
Referenced by basic_ostream::write().
bool bad | ( | ) | const [inline, inherited] |
Fast error checking.
Definition at line 197 of file basic_ios.h.
References ios_base::badbit, and basic_ios::rdstate().
[Re]sets the error state.
state | The new state flag(s) to set. |
Definition at line 44 of file basic_ios.tcc.
References ios_base::badbit, basic_ios::exceptions(), basic_ios::rdbuf(), 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().
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 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().
bool eof | ( | ) | const [inline, inherited] |
Fast error checking.
Definition at line 176 of file basic_ios.h.
References ios_base::eofbit, and basic_ios::rdstate().
Referenced by basic_istream::get(), basic_istream::getline(), basic_istream::ignore(), basic_istream::peek(), basic_istream::putback(), basic_istream::sentry::sentry(), and basic_istream::unget().
void 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.
References basic_ios::clear().
iostate exceptions | ( | ) | const [inline, inherited] |
Throwing exceptions on errors.
Definition at line 208 of file basic_ios.h.
Referenced by basic_ios::clear(), and basic_ios::copyfmt().
bool fail | ( | ) | const [inline, inherited] |
Fast error checking.
Definition at line 187 of file basic_ios.h.
References ios_base::badbit, ios_base::failbit, and basic_ios::rdstate().
Referenced by basic_ios::operator void *(), basic_ios::operator!(), basic_istream::seekg(), basic_ostream::seekp(), basic_istream::tellg(), and basic_ostream::tellp().
Sets a new "empty" character.
ch | The new character. |
Definition at line 376 of file basic_ios.h.
References basic_ios::fill().
char_type fill | ( | ) | const [inline, inherited] |
Retreives the "empty" character.
Definition at line 356 of file basic_ios.h.
References basic_ios::widen().
Referenced by basic_ios::copyfmt(), and basic_ios::fill().
Setting new format flags all at once.
fmtfl | The new flags to set. |
Definition at line 558 of file ios_base.h.
fmtflags flags | ( | ) | const [inline, inherited] |
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(), basic_ostream::operator<<(), and basic_istream::sentry::sentry().
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 506 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, basic_ios::rdbuf(), and basic_ios::setstate().
Referenced by std::flush().
locale 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 690 of file ios_base.h.
Referenced by basic_ios::copyfmt(), money_put::do_put(), basic_ios::imbue(), std::operator>>(), and std::ws().
bool good | ( | ) | const [inline, inherited] |
Fast error checking.
Definition at line 166 of file basic_ios.h.
References basic_ios::rdstate().
Referenced by basic_ostream::sentry::sentry(), and basic_istream::sentry::sentry().
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 ios_base.
Definition at line 127 of file basic_ios.tcc.
References ios_base::getloc(), and basic_ios::rdbuf().
void 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 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().
long& 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 734 of file ios_base.h.
char 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.
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.
References basic_ios::fail().
bool 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.
References basic_ios::fail().
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 430 of file ostream.tcc.
References ios_base::badbit, ios_base::failbit, ios_base::goodbit, basic_ios::rdbuf(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | const void * | __p | ) | [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 407 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | long double | __f | ) | [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 384 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | float | __f | ) | [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 335 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | double | __f | ) | [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 361 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | unsigned long long | __n | ) | [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 311 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | long long | __n | ) | [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 288 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | unsigned int | __n | ) | [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 215 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | int | __n | ) | [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 183 of file ostream.tcc.
References ios_base::badbit, ios_base::basefield, ios_base::flags(), ios_base::goodbit, ios_base::hex, ios_base::oct, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | unsigned short | __n | ) | [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 157 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | short | __n | ) | [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 125 of file ostream.tcc.
References ios_base::badbit, ios_base::basefield, ios_base::flags(), ios_base::goodbit, ios_base::hex, ios_base::oct, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | bool | __n | ) | [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 102 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & operator<< | ( | unsigned long | __n | ) | [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 264 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
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 241 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, num_put::put(), and basic_ios::setstate().
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 90 of file ostream.tcc.
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 78 of file ostream.tcc.
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 67 of file ostream.tcc.
streamsize precision | ( | streamsize | __prec | ) | [inline, inherited] |
Changing flags.
prec | The new precision value. |
Definition at line 626 of file ios_base.h.
streamsize precision | ( | ) | const [inline, inherited] |
Flags access.
Definition at line 618 of file ios_base.h.
Referenced by basic_ios::copyfmt().
basic_ostream< _CharT, _Traits > & put | ( | char_type | __c | ) | [inline, inherited] |
Simple insertion.
c | The character to insert. |
Definition at line 454 of file ostream.tcc.
References ios_base::badbit, ios_base::goodbit, basic_ios::rdbuf(), and basic_ios::setstate().
Referenced by std::endl(), and std::ends().
void*& 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 755 of file ios_base.h.
basic_streambuf< _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 56 of file basic_ios.tcc.
References basic_ios::clear().
__stringbuf_type* rdbuf | ( | ) | const [inline] |
Accessing the underlying buffer.
Reimplemented from basic_ios.
iostate rdstate | ( | ) | const [inline, inherited] |
Returns the error state of the stream buffer.
Definition at line 123 of file basic_ios.h.
Referenced by basic_ios::bad(), basic_ios::clear(), basic_ios::eof(), basic_ios::fail(), basic_ios::good(), and basic_ios::setstate().
void 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. |
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 570 of file ostream.tcc.
References ios_base::badbit, basic_ios::fail(), ios_base::failbit, ios_base::goodbit, ios_base::out, basic_ios::rdbuf(), and basic_ios::setstate().
basic_ostream< _CharT, _Traits > & seekp | ( | pos_type | __pos | ) | [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 543 of file ostream.tcc.
References ios_base::badbit, basic_ios::fail(), ios_base::failbit, ios_base::goodbit, ios_base::out, basic_ios::rdbuf(), and basic_ios::setstate().
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 591 of file ios_base.h.
Setting new format flags.
fmtfl | Additional flags to set. |
Definition at line 574 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().
void 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.
References basic_ios::clear(), and basic_ios::rdstate().
Referenced by basic_ostream::_M_write(), basic_fstream::close(), basic_ofstream::close(), basic_ifstream::close(), basic_ostream::flush(), basic_istream::get(), std::getline(), basic_istream::getline(), basic_istream::ignore(), basic_fstream::open(), basic_ofstream::open(), basic_ifstream::open(), 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_ostream::sentry::sentry(), basic_istream::sentry::sentry(), basic_istream::sync(), basic_istream::unget(), and std::ws().
void str | ( | const __string_type & | __s | ) | [inline] |
__string_type str | ( | ) | const [inline] |
static bool sync_with_stdio | ( | bool | __sync = true |
) | [static, inherited] |
Interaction with the standard C I/O objects.
sync | Whether to synchronize or not. |
basic_ostream< _CharT, _Traits >::pos_type 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 527 of file ostream.tcc.
References ios_base::badbit, ios_base::cur, basic_ios::fail(), ios_base::out, and basic_ios::rdbuf().
basic_ostream<_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_ostream<_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 basic_ios::copyfmt(), basic_ostream::sentry::sentry(), and basic_istream::sentry::sentry().
void unsetf | ( | fmtflags | __mask | ) | [inline, inherited] |
Clearing format flags.
mask | The flags to unset. |
Definition at line 606 of file ios_base.h.
Referenced by std::noboolalpha(), std::noshowbase(), std::noshowpoint(), std::noshowpos(), std::noskipws(), std::nounitbuf(), and std::nouppercase().
_CharT 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(), basic_ios::fill(), basic_istream::get(), std::getline(), basic_istream::getline(), and std::operator>>().
streamsize width | ( | streamsize | __wide | ) | [inline, inherited] |
Changing flags.
wide | The new width value. |
Definition at line 648 of file ios_base.h.
streamsize width | ( | ) | const [inline, inherited] |
Flags access.
Definition at line 640 of file ios_base.h.
Referenced by basic_ios::copyfmt(), num_put::do_put(), and std::operator>>().
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 483 of file ostream.tcc.
References basic_ostream::_M_write(), and ios_base::badbit.
static int 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.
const fmtflags 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().
Open and seek to end immediately after opening.
Definition at line 365 of file ios_base.h.
Referenced by basic_filebuf::open().
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 basic_ostream::_M_write(), 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(), basic_istream::unget(), basic_ostream::write(), and basic_ostream::sentry::~sentry().
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(), num_get::do_get(), 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().
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.
Referenced by basic_filebuf::showmanyc().
Insert/extract bool
in alphabetic rather than numeric format.
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(), basic_istream::sentry::sentry(), and std::ws().
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 basic_fstream::close(), basic_ofstream::close(), basic_ifstream::close(), num_get::do_get(), time_get::do_get_monthname(), time_get::do_get_weekday(), time_get::do_get_year(), 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(), basic_ostream::seekp(), basic_ostream::sentry::sentry(), and basic_istream::sentry::sentry().
Generate floating-point output in fixed-point notation.
Definition at line 262 of file ios_base.h.
Referenced by std::fixed().
const fmtflags 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().
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::sentry::sentry(), 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 num_get::do_get(), num_put::do_put(), std::hex(), and basic_ostream::operator<<().
Open for input. Default for ifstream
and fstream.
Definition at line 374 of file ios_base.h.
Referenced by basic_filebuf::pbackfail(), basic_istream::seekg(), basic_stringbuf::seekoff(), basic_stringbuf::seekpos(), basic_stringbuf::showmanyc(), basic_filebuf::showmanyc(), basic_istream::tellg(), basic_stringbuf::underflow(), basic_filebuf::underflow(), and basic_filebuf::xsgetn().
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 num_put::do_put(), and std::internal().
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().
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 ofstream
and fstream.
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(), basic_ostream::tellp(), and basic_filebuf::xsputn().
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 fmtflags scientific [static, inherited] |
Generates floating-point output in scientific notation.
Definition at line 284 of file ios_base.h.
Referenced by std::scientific().
Generates a prefix indicating the numeric base of generated integer output.
Definition at line 288 of file ios_base.h.
Referenced by num_put::do_put(), std::noshowbase(), and std::showbase().
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().
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(), basic_istream::sentry::sentry(), and std::skipws().
Flushes output after each output operation.
Definition at line 301 of file ios_base.h.
Referenced by std::nounitbuf(), std::unitbuf(), and basic_ostream::sentry::~sentry().
Replaces certain lowercase letters with their uppercase equivalents in generated output.
Definition at line 305 of file ios_base.h.
Referenced by num_put::do_put(), std::nouppercase(), and std::uppercase().