bsl::basic_string::basic_string

Synopsis

Declared in <bslstl_string.h>

basic_string(
    BloombergLP::bslmf::MovableRef<basic_string> original,
    size_type position,
    ALLOCATOR const& basicAllocator = ALLOCATOR());

Description

Create a string that has the same value as the substring starting at the specified position in the specified original string. Optionally specify the basicAllocator used to supply memory. If basicAllocator is not specified, a default-constructed allocator is used. The contents of original are moved (in constant time) to the new string if basicAllocator == original.get_allocator(), and are copied (in linear time) using basicAllocator otherwise. original is left in a valid but unspecified state. Throw out_of_range if `position > original.length()`.

Parameters

Name	Description
original	source string
position	starting index
basicAllocator	allocator used to supply memory