Initializes the input and output sequences frombuf according tomode.buf andmode areexposition-only data members of*this.

Immediately after this function returns:

• Ifstd::ios_base::out is set inmode,pbase() points tobuf.front() andepptr()>= pbase()+ buf.size() istrue;
  • in addition, ifstd::ios_base::ate is set inmode,pptr()== pbase()+ buf.size() istrue,
  • otherwisepptr()== pbase() istrue.
• Ifstd::ios_base::in is set inmode,eback() points tobuf.front(), andgptr()== eback()&& egptr()== eback()+ buf.size() istrue.

[edit]Notes

For efficiency reasons, stream buffer operations can violate invariants ofbuf while it is held encapsulated in thestd::basic_stringbuf, e.g., by writing to characters in the range[buf.data()+ buf.size(), buf.data()+ buf.capacity()).

All operations retrieving astd::basic_string frombuf ensure that thestd::basic_string invariants hold on the returned value.

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

• In other languages

• Русский
• 中文