29 Input/output library [input.output]

29.8 String-based streams [string.streams]

29.8.2 Class template basic_­stringbuf [stringbuf]

29.8.2.2 Constructors [stringbuf.cons]

🔗
explicit basic_stringbuf(ios_base::openmode which);
1
#
Effects: Initializes the base class with basic_­streambuf() ([streambuf.cons]), and mode with which.
It is implementation-defined whether the sequence pointers (eback(), gptr(), egptr(), pbase(), pptr(), epptr()) are initialized to null pointers.
2
#
Postconditions: str().empty() is true.
🔗
explicit basic_stringbuf( const basic_string<charT, traits, Allocator>& s, ios_base::openmode which = ios_base::in | ios_base::out);
3
#
Effects: Initializes the base class with basic_­streambuf() ([streambuf.cons]), mode with which, and buf with s, then calls init_­buf_­ptrs().
🔗
basic_stringbuf(ios_base::openmode which, const Allocator &a);
4
#
Effects: Initializes the base class with basic_­streambuf() ([streambuf.cons]), mode with which, and buf with a, then calls init_­buf_­ptrs().
5
#
Postconditions: str().empty() is true.
🔗
explicit basic_stringbuf( basic_string<charT, traits, Allocator>&& s, ios_base::openmode which = ios_base::in | ios_base::out);
6
#
Effects: Initializes the base class with basic_­streambuf() ([streambuf.cons]), mode with which, and buf with std​::​move(s), then calls init_­buf_­ptrs().
🔗
template<class SAlloc> basic_stringbuf( const basic_string<charT, traits, SAlloc>& s, ios_base::openmode which, const Allocator &a);
7
#
Effects: Initializes the base class with basic_­streambuf() ([streambuf.cons]), mode with which, and buf with {s,a}, then calls init_­buf_­ptrs().
🔗
template<class SAlloc> explicit basic_stringbuf( const basic_string<charT, traits, SAlloc>& s, ios_base::openmode which = ios_base::in | ios_base::out);
8
#
Constraints: is_­same_­v<SAlloc,Allocator> is false.
9
#
Effects: Initializes the base class with basic_­streambuf() ([streambuf.cons]), mode with which, and buf with s, then calls init_­buf_­ptrs().
🔗
basic_stringbuf(basic_stringbuf&& rhs); basic_stringbuf(basic_stringbuf&& rhs, const Allocator& a);
10
#
Effects: Copy constructs the base class from rhs and initializes mode with rhs.mode.
In the first form buf is initialized from std​::​move(rhs).str().
In the second form buf is initialized from {std​::​move(rhs).str(), a}.
It is implementation-defined whether the sequence pointers in *this (eback(), gptr(), egptr(), pbase(), pptr(), epptr()) obtain the values which rhs had.
11
#
Postconditions: Let rhs_­p refer to the state of rhs just prior to this construction and let rhs_­a refer to the state of rhs just after this construction.
  • (11.1)
    str() == rhs_­p.str()
  • (11.2)
    gptr() - eback() == rhs_­p.gptr() - rhs_­p.eback()
  • (11.3)
    egptr() - eback() == rhs_­p.egptr() - rhs_­p.eback()
  • (11.4)
    pptr() - pbase() == rhs_­p.pptr() - rhs_­p.pbase()
  • (11.5)
    epptr() - pbase() == rhs_­p.epptr() - rhs_­p.pbase()
  • (11.6)
    if (eback()) eback() != rhs_­a.eback()
  • (11.7)
    if (gptr()) gptr() != rhs_­a.gptr()
  • (11.8)
    if (egptr()) egptr() != rhs_­a.egptr()
  • (11.9)
    if (pbase()) pbase() != rhs_­a.pbase()
  • (11.10)
    if (pptr()) pptr() != rhs_­a.pptr()
  • (11.11)
    if (epptr()) epptr() != rhs_­a.epptr()
  • (11.12)
    getloc() == rhs_­p.getloc()
  • (11.13)
    rhs is empty but usable, as if std​::​move(rhs).str() was called.