class
<ios> <iostream>
std::ios
typedef basic_ios<char> ios;
Base class for streams (type-dependent components)
Base class for all stream classes using narrow characters (of type char)
This is an instantiation of basic_ios with the following template parameters:
| template parameter | definition | comments |
|---|
| charT | char | Aliased as member char_type |
| traits | char_traits<char> | Aliased as member traits_type |
Both this class and its parent class, ios_base, define the components of streams that do not depend on whether the stream is an input or an output stream. ios_base describes the members that are independent of the template parameters, while this one describes the members that are dependent on the template parameters.
The class adds to the information kept by its inherited ios_base component, the following:
| field | member functions | description |
|---|
| Formatting | fill character | fill | Character to pad a formatted field up to the field width (width). |
| State | error state | rdstate
setstate
clear | The current error state of the stream.
Individual values may be obtained by calling good, eof, fail and bad.
See member type iostate. |
| exception mask | exceptions | The state flags for which a failure exception is thrown.
See member type iostate. |
| Other | tied stream | tie | Pointer to output stream that is flushed before each i/o operation on this stream. |
| stream buffer | rdbuf | Pointer to the associated streambuf object, which is charge of all input/output operations. |
Member types
Along with the member types inherited from ios_base:
- event
- Type to indicate event type (public member type)
- event_callback
- Event callback function type (public member type)
- failure
- Base class for stream exceptions (public member class)
- fmtflags
- Type for stream format flags (public member type)
- Init
- Initialize standard stream objects (public member class)
- iostate
- Type for stream state flags (public member type)
- openmode
- Type for stream opening mode flags (public member type)
- seekdir
- Type for stream seeking direction flag (public member type)
Public member functions
- (constructor)
- Construct object (public member function)
- (destructor)
- Destroy object (public member function)
State flag functions:
- good
- Check whether state of stream is good (public member function)
- eof
- Check whether eofbit is set (public member function)
- fail
- Check whether either failbit or badbit is set (public member function)
- bad
- Check whether badbit is set (public member function)
- operator!
- Evaluate stream (not) (public member function)
- operator bool
- Evaluate stream (public member function)
- rdstate
- Get error state flags (public member function)
- setstate
- Set error state flag (public member function)
- clear
- Set error state flags (public member function)
Formatting:
- copyfmt
- Copy formatting information (public member function)
- fill
- Get/set fill character (public member function)
Other:
- exceptions
- Get/set exceptions mask (public member function)
- imbue
- Imbue locale (public member function)
- tie
- Get/set tied stream (public member function)
- rdbuf
- Get/set stream buffer (public member function)
- narrow
- Narrow character (public member function)
- widen
- Widen character (public member function)
Protected member functions
- init
- Initialize object (protected member function)
- move
- Move internals (protected member function)
- swap
- Swap internals (protected member function)
- set_rdbuf
- Set stream buffer (protected member function)
Public member functions inherited from ios_base
- flags
- Get/set format flags (public member function)
- setf
- Set specific format flags (public member function)
- unsetf
- Clear specific format flags (public member function)
- precision
- Get/Set floating-point decimal precision (public member function)
- width
- Get/set field width (public member function)
- imbue
- Imbue locale (public member function)
- getloc
- Get current locale (public member function)
- xalloc
- Get new index for extensible array [static] (public static member function)
- iword
- Get integer element of extensible array (public member function)
- pword
- Get pointer element of extensible array (public member function)
- register_callback
- Register event callback function (public member function)
- sync_with_stdio
- Toggle synchronization with cstdio streams [static] (public static member function)