#include <ios_base.h>
Public Types | |
enum | event |
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) |
Public Member Functions | |
void | register_callback (event_callback __fn, int 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 | imbue (const locale &__loc) |
Setting a new locale. | |
locale | getloc () const |
Locale access. | |
const locale & | M_getloc () const |
Locale access. | |
long & | iword (int __ix) |
void *& | pword (int __ix) |
~ios_base () | |
Static Public Member Functions | |
static bool | sync_with_stdio (bool sync=true) |
Interaction with the standard C I/O objects. | |
static int | xalloc () throw () |
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. | |
Classes | |
class | failure |
These are thrown to indicate problems. Doc me. More... |
This class defines everything that can be defined about I/O that does not depend on the type of characters being input or output. Most people will only see ios_base
when they need to specify the full name of the various I/O flags (e.g., the openmodes).
Definition at line 158 of file ios_base.h.
typedef IosFmtflags std::ios_base::fmtflags |
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 212 of file ios_base.h.
typedef IosIostate std::ios_base::iostate |
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 269 of file ios_base.h.
typedef IosOpenmode std::ios_base::openmode |
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 296 of file ios_base.h.
typedef IosSeekdir std::ios_base::seekdir |
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 323 of file ios_base.h.
typedef void(* std::ios_base::event_callback)(event, ios_base &, int) |
enum std::ios_base::event |
Definition at line 345 of file ios_base.h.
std::ios_base::~ios_base | ( | ) |
void std::ios_base::register_callback | ( | event_callback | __fn, | |
int | index | |||
) |
fmtflags std::ios_base::flags | ( | ) | const [inline] |
Access to format flags.
Definition at line 472 of file ios_base.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), std::basic_ostream< CharT, Traits >::operator<<(), std::basic_ostream< char >::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 482 of file ios_base.h.
Setting new format flags.
fmtfl | Additional flags to set. |
Definition at line 498 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 515 of file ios_base.h.
void std::ios_base::unsetf | ( | fmtflags | __mask | ) | [inline] |
Clearing format flags.
mask | The flags to unset. |
Definition at line 530 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] |
Flags access.
Definition at line 542 of file ios_base.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt().
streamsize std::ios_base::precision | ( | streamsize | __prec | ) | [inline] |
Changing flags.
prec | The new precision value. |
Definition at line 550 of file ios_base.h.
streamsize std::ios_base::width | ( | ) | const [inline] |
Flags access.
Definition at line 564 of file ios_base.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), and std::operator>>().
streamsize std::ios_base::width | ( | streamsize | __wide | ) | [inline] |
Changing flags.
wide | The new width value. |
Definition at line 572 of file ios_base.h.
bool std::ios_base::sync_with_stdio | ( | bool | sync = true |
) | [static] |
Interaction with the standard C I/O objects.
sync | Whether to synchronize or not. |
locale std::ios_base::imbue | ( | const locale & | __loc | ) |
Setting a new locale.
loc | The new locale. |
Reimplemented in std::basic_ios< CharT, Traits >, and std::basic_ios< char, Traits >.
Definition at line 304 of file ios.cc.
Referenced by std::basic_ios< CharT, Traits >::imbue().
locale std::ios_base::getloc | ( | ) | const [inline] |
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 614 of file ios_base.h.
Referenced by std::basic_ios< CharT, Traits >::copyfmt(), std::basic_ios< CharT, Traits >::imbue(), std::operator>>(), and std::ws().
const locale& std::ios_base::M_getloc | ( | ) | const [inline] |
Locale access.
Definition at line 624 of file ios_base.h.
int std::ios_base::xalloc | ( | ) | throw () [static] |
long& std::ios_base::iword | ( | int | __ix | ) | [inline] |
Definition at line 637 of file ios_base.h.
void*& std::ios_base::pword | ( | int | __ix | ) | [inline] |
Definition at line 648 of file ios_base.h.
const ios_base::fmtflags std::ios_base::boolalpha [static] |
Insert/extract bool
in alphabetic rather than numeric format.
Definition at line 214 of file ios_base.h.
Referenced by std::boolalpha(), and std::noboolalpha().
const ios_base::fmtflags std::ios_base::dec [static] |
Converts integer input or generates integer output in decimal base.
Definition at line 216 of file ios_base.h.
Referenced by std::dec().
const ios_base::fmtflags std::ios_base::fixed [static] |
Generate floating-point output in fixed-point notation.
Definition at line 218 of file ios_base.h.
Referenced by std::fixed().
const ios_base::fmtflags std::ios_base::hex [static] |
Converts integer input or generates integer output in hexadecimal base.
Definition at line 220 of file ios_base.h.
Referenced by std::hex(), std::basic_ostream< CharT, Traits >::operator<<(), and std::basic_ostream< char >::operator<<().
const ios_base::fmtflags std::ios_base::internal [static] |
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 224 of file ios_base.h.
Referenced by std::internal().
const ios_base::fmtflags std::ios_base::left [static] |
Adds fill characters on the right (final positions) of certain generated output. (I.e., the thing you print is flush left.).
Definition at line 227 of file ios_base.h.
Referenced by std::left().
const ios_base::fmtflags std::ios_base::oct [static] |
Converts integer input or generates integer output in octal base.
Definition at line 229 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] |
Adds fill characters on the left (initial positions) of certain generated output. (I.e., the thing you print is flush right.).
Definition at line 232 of file ios_base.h.
Referenced by std::right().
const ios_base::fmtflags std::ios_base::scientific [static] |
Generates floating-point output in scientific notation.
Definition at line 234 of file ios_base.h.
Referenced by std::scientific().
const ios_base::fmtflags std::ios_base::showbase [static] |
Generates a prefix indicating the numeric base of generated integer output.
Definition at line 237 of file ios_base.h.
Referenced by std::noshowbase(), and std::showbase().
const ios_base::fmtflags std::ios_base::showpoint [static] |
Generates a decimal-point character unconditionally in generated floating-point output.
Definition at line 240 of file ios_base.h.
Referenced by std::noshowpoint(), and std::showpoint().
const ios_base::fmtflags std::ios_base::showpos [static] |
Generates a + sign in non-negative generated numeric output.
Definition at line 242 of file ios_base.h.
Referenced by std::noshowpos(), and std::showpos().
const ios_base::fmtflags std::ios_base::skipws [static] |
Skips leading white space before certain input operations.
Definition at line 244 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] |
Flushes output after each output operation.
Definition at line 246 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] |
Replaces certain lowercase letters with their uppercase equivalents in generated output.
Definition at line 249 of file ios_base.h.
Referenced by std::nouppercase(), and std::uppercase().
const ios_base::fmtflags std::ios_base::adjustfield [static] |
A mask of left|right|internal. Useful for the 2-arg form of setf
.
Definition at line 251 of file ios_base.h.
Referenced by std::internal(), std::left(), and std::right().
const ios_base::fmtflags std::ios_base::basefield [static] |
A mask of dec|oct|hex. Useful for the 2-arg form of setf
.
Definition at line 253 of file ios_base.h.
Referenced by std::dec(), 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] |
A mask of scientific|fixed. Useful for the 2-arg form of setf
.
Definition at line 255 of file ios_base.h.
Referenced by std::fixed(), and std::scientific().
const ios_base::iostate std::ios_base::badbit [static] |
Indicates a loss of integrity in an input or output sequence (such as an irrecoverable read error from a file).
Definition at line 272 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::basic_istream< CharT, Traits >::getline(), std::basic_istream< CharT, Traits >::ignore(), std::basic_ios< CharT, Traits >::init(), std::operator<<(), std::basic_ostream< CharT, Traits >::operator<<(), std::operator>>(), std::basic_istream< CharT, Traits >::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] |
Indicates that an input operation reached the end of an input sequence.
Definition at line 274 of file ios_base.h.
Referenced by std::basic_ios< char, Traits >::eof(), std::basic_istream< CharT, Traits >::get(), 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] |
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 278 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::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] |
Indicates all is well.
Definition at line 280 of file ios_base.h.
Referenced by std::basic_ostream< CharT, Traits >::flush(), std::basic_istream< CharT, Traits >::get(), 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(), std::basic_istream< CharT, Traits >::unget(), and std::basic_ostream< CharT, Traits >::write().
const ios_base::openmode std::ios_base::app [static] |
const ios_base::openmode std::ios_base::ate [static] |
Open and seek to end immediately after opening.
Definition at line 300 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::open().
const ios_base::openmode std::ios_base::binary [static] |
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 305 of file ios_base.h.
const ios_base::openmode std::ios_base::in [static] |
Open for input. Default for ifstream
and fstream.
Definition at line 307 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_filebuf< CharT, Traits >::seekoff(), std::basic_stringbuf< CharT, Traits, Alloc >::seekpos(), std::basic_streambuf< char, std::std::char_traits< char > >::setg(), std::basic_filebuf< CharT, Traits >::showmanyc(), and std::basic_istream< CharT, Traits >::tellg().
const ios_base::openmode std::ios_base::out [static] |
Open for output. Default for ofstream
and fstream.
Definition at line 309 of file ios_base.h.
Referenced by std::basic_stringbuf< CharT, Traits, Alloc >::overflow(), std::basic_filebuf< CharT, Traits >::overflow(), std::basic_filebuf< CharT, Traits >::pbackfail(), std::basic_stringbuf< CharT, Traits, Alloc >::seekoff(), std::basic_filebuf< CharT, Traits >::seekoff(), std::basic_ostream< CharT, Traits >::seekp(), std::basic_stringbuf< CharT, Traits, Alloc >::seekpos(), std::basic_streambuf< char, std::std::char_traits< char > >::setp(), std::basic_stringbuf< CharT, Traits, Alloc >::str(), std::basic_ostream< CharT, Traits >::tellp(), and std::basic_streambuf< char, std::std::char_traits< char > >::uflow().
const ios_base::openmode std::ios_base::trunc [static] |
const ios_base::seekdir std::ios_base::beg [static] |
Request a seek relative to the beginning of the stream.
Definition at line 325 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::seekpos().
const ios_base::seekdir std::ios_base::cur [static] |
Request a seek relative to the current position within the sequence.
Definition at line 327 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::pbackfail(), std::basic_stringbuf< CharT, Traits, Alloc >::seekoff(), std::basic_filebuf< CharT, Traits >::seekoff(), std::basic_filebuf< CharT, __gnu_cxx::enc_char_traits< CharT > >::sync(), std::basic_istream< CharT, Traits >::tellg(), and std::basic_ostream< CharT, Traits >::tellp().
const ios_base::seekdir std::ios_base::end [static] |
Request a seek relative to the current end of the sequence.
Definition at line 329 of file ios_base.h.
Referenced by std::basic_filebuf< CharT, Traits >::open(), and std::basic_stringbuf< CharT, Traits, Alloc >::seekoff().