30.5.5 Class template basic_ios [ios]
basic_ostream<charT, traits>* tie() const;
Returns:
An output sequence that is
tied
to (synchronized with) the sequence controlled by the stream buffer
. basic_ostream<charT, traits>* tie(basic_ostream<charT, traits>* tiestr);
Requires:
If
tiestr is not null,
tiestr must not be reachable by
traversing the linked list of tied stream objects starting from
tiestr->tie(). Postconditions:
tiestr == tie(). Returns:
The previous value of
tie(). basic_streambuf<charT, traits>* rdbuf() const;
Returns:
A pointer to the
streambuf
associated with the stream
. basic_streambuf<charT, traits>* rdbuf(basic_streambuf<charT, traits>* sb);
Postconditions:
sb == rdbuf(). Returns:
The previous value of
rdbuf(). locale imbue(const locale& loc);
Returns:
The prior value of
ios_base::imbue(). char narrow(char_type c, char dfault) const;
Returns:
use_facet<ctype<char_type>>(getloc()).narrow(c, dfault)
char_type widen(char c) const;
Returns:
use_facet<ctype<char_type>>(getloc()).widen(c)
char_type fill() const;
Returns:
The character used to pad (fill) an output conversion to the specified
field width
. char_type fill(char_type fillch);
Postconditions:
traits::eq(fillch, fill()). Returns:
The previous value of
fill(). basic_ios& copyfmt(const basic_ios& rhs);
Effects:
If
(this == &rhs)
does nothing
. Otherwise assigns to the member objects of
*this
the corresponding member objects of rhs as follows:
- 1.
calls each registered callback pair (fn, index) as
(*fn)(erase_event, *this, index);
- 2.
assigns to the member objects of *this the corresponding member objects of
rhs, except that
rdstate(), rdbuf(), and exceptions() are left unchanged;
the contents of arrays pointed at by pword and iword are copied,
not the pointers themselves;
and
if any newly stored pointer values in *this point at objects stored outside
the object rhs and those objects are destroyed when rhs is destroyed, the
newly stored pointer values are altered to point at newly constructed copies of the
objects;
- 3.
calls each callback pair that was copied from rhs as
(*fn)(copyfmt_event, *this, index);
- 4.
calls
exceptions(rhs.exceptions()).
[
Note: The second pass through the callback pairs permits a copied
pword
value to be zeroed, or to have its referent deep copied or reference counted, or to have
other special action taken
. —
end note ]
Postconditions:
The postconditions of this function are indicated in Table
109. Table
109 —
basic_ios::copyfmt() effects
Element | Value |
rdbuf() | unchanged |
tie() | rhs.tie() |
rdstate() | unchanged |
exceptions() | rhs.exceptions() |
flags() | rhs.flags() |
width() | rhs.width() |
precision() | rhs.precision() |
fill() | rhs.fill() |
getloc() | rhs.getloc() |
void move(basic_ios& rhs);
void move(basic_ios&& rhs);
Postconditions: *this shall have the state that
rhs had before the function call, except that
rdbuf() shall return 0
. rhs shall be in a valid but
unspecified state, except that
rhs.rdbuf() shall return the
same value as it returned before the function call, and
rhs.tie() shall return 0
. void swap(basic_ios& rhs) noexcept;
Effects: The states of
*this and
rhs
shall be exchanged, except that
rdbuf() shall return the same
value as it returned before the function call, and
rhs.rdbuf()
shall return the same value as it returned before the function call
. void set_rdbuf(basic_streambuf<charT, traits>* sb);
Effects: Associates the
basic_streambuf object
pointed to by
sb with this stream without calling
clear(). Postconditions: rdbuf() == sb.