| void init_buf_ptrs(); |
(exposition only*) | |
Initializes the input and output sequences from buf according to mode. buf and mode are exposition-only data members of *this.
Immediately after this function returns:
- If std::ios_base::out is set in
mode,pbase()points tobuf.front()andepptr() >= pbase() + buf.size()istrue;- in addition, if std::ios_base::ate is set in
mode,pptr() == pbase() + buf.size()istrue, - otherwise
pptr() == pbase()istrue.
- in addition, if std::ios_base::ate is set in
- If std::ios_base::in is set in
mode,eback()points tobuf.front(), andgptr() == eback() && egptr() == eback() + buf.size()istrue.
Notes
For efficiency reasons, stream buffer operations can violate invariants of buf while it is held encapsulated in the std::basic_stringbuf, e.g., by writing to characters in the range [buf.data() + buf.size(), buf.data() + buf.capacity()).
All operations retrieving a std::basic_string from buf ensure that the std::basic_string invariants hold on the returned value.
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 1448 | C++98 | calling init_buf_ptrs() madepptr() == pbase() + buf.data()for streams that are both input and output streams |
makespptr() == pbase() + buf.size()for append streams |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.