Create a basic_stringbuf from a string and open mode.

Synopsis

Declared in <bslstl_stringbuf.h>

template<class SALLOC>
basic_stringbuf(
    bsl::basic_string<CHAR_TYPE, CHAR_TRAITS, SALLOC> const& initialString,
    std::ios_base::openmode modeBitMask,
    allocator_type const& allocator = allocator_type())
requires !bsl::is_same<ALLOCATOR, SALLOC>::value;

Description

Create a basic_stringbuf object. Use the specified initialString indicating the initial sequence of characters that this buffer will access or manipulate. Use the specified modeBitMask to indicate whether this buffer may be read from, written to, or both. Optionally specify the allocator used to supply memory. If allocator is not supplied, a default‐constructed object of the (template parameter) allocator_type is used. If the ALLOCATOR argument is of type bsl::allocator (the default), then allocator, if supplied, shall be convertible to bslma::Allocator *. If the ALLOCATOR argument is of type bsl::allocator and allocator is not supplied, the currently installed default allocator will be used to supply memory.

Parameters

Name

Description

initialString

initial character sequence for the buffer

modeBitMask

open mode for the stream buffer

allocator

allocator used to supply memory

Created with MrDocs