bsl::basic_string::basic_string

Synopsis

Declared in <bslstl_string.h>

basic_string(
    basic_string const& original,
    size_type position,
    size_type numChars,
    ALLOCATOR const& basicAllocator = ALLOCATOR());

Description

Create a string that has the same value as the substring of the specified numChars length starting at the specified position in the specified original string. If numChars equals npos, then the remaining length of the string is used (i.e., numChars is set to original.length() - position). Optionally specify the basicAllocator used to supply memory. If basicAllocator is not specified, a default-constructed allocator is used. Throw out_of_range if position > original.length().

Parameters

Name	Description
original	source string
position	starting index
numChars	number of characters
basicAllocator	allocator used to supply memory