bsl::basic_stringbuf::basic_stringbuf

Create a basic_stringbuf from a string with a different allocator.

Synopsis

Declared in <bslstl_stringbuf.h>

template<class SALLOC>
explicit
basic_stringbuf(
    bsl::basic_string<CHAR_TYPE, CHAR_TRAITS, SALLOC> const& initialString,
    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. 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

NameDescription
initialStringinitial character sequence for the buffer
allocatorallocator used to supply memory