bsl::basic_string<char16_t>

Name

Description

allocator_type

Alias for the (template parameter) ALLOCATOR type.

const_iterator

Alias for a constant iterator over the characters of this string.

const_pointer

Alias for a constant pointer to the character type.

const_reference

Alias for a non‐modifiable reference to the character type.

const_reverse_iterator

These types satisfy the ReversibleSequence requirements.

difference_type

This typedef is an alias to AllocatorTraits::difference_type.

iterator

Alias for an iterator over the characters of this string.

pointer

Alias for a pointer to the character type.

reference

Alias for a modifiable reference to the character type.

reverse_iterator

Alias for a reverse iterator over the characters of this string.

size_type

Alias for the size type of this string.

traits_type

Alias for the (template parameter) CHAR_TRAITS type.

value_type

Alias for the character type stored in this string.

Name

Description

basic_string [constructor]

Constructors

~basic_string [destructor]

Destroy this string object.

operator=

Assignment operators

append

append overloads

append_range

Append to this string the characters from the specified range. Return a reference providing modifiable access to this string. Note that range must meet the requirements of an input range and the values from range must have a type matching or convertible to (template parameter) CHAR_TYPE.

assign

assign overloads

assign_range

Assign to this string the characters from the specified range. Return a reference providing modifiable access to this string. Note that range must meet the requirements of an input range and the values from range must have a type matching or convertible to (template parameter) CHAR_TYPE.

at

at overloads

back

back overloads

begin

begin overloads

c_str

Return an address providing non‐modifiable access to the null‐terminated buffer of length() + 1 characters whose contents are identical to the value of this string. Note that any call to the string destructor or any of its manipulators invalidates the returned pointer.

capacity

Return the capacity of this string, i.e., the maximum length for which resizing is guaranteed not to trigger a reallocation.

cbegin

Return an iterator providing non‐modifiable access to the first character of this string (or the past‐the‐end iterator if this string is empty).

cend

Return the past‐the‐end iterator for this string.

clear

Reset this string to an empty value. Note that the capacity may change (or not if BASIC_STRING_DEALLOCATE_IN_CLEAR is false). Note that the Standard doesn't allow to reduce capacity on clear.

compare

compare overloads

contains

contains overloads

copy

Copy from this string, starting from the optionally specified position, the specified numChars or length() ‐ position characters, whichever is smaller, into the specified characterString buffer, and return the number of characters copied. If position is not specified, 0 is used. Throw out_of_range if position > length(). The behavior is undefined unless characterString is at least numChars long. Note that the output characterString is not null‐terminated.

crbegin

Return a reverse iterator providing non‐modifiable access to the last character of this string (or the past‐the‐end reverse iterator if this string is empty).

crend

Return the past‐the‐end reverse iterator for this string.

data

data overloads

empty

Return true if this string has length 0, and false otherwise.

end

end overloads

ends_with

ends_with overloads

erase

erase overloads

find

find overloads

find_first_not_of

find_first_not_of overloads

find_first_of

find_first_of overloads

find_last_not_of

find_last_not_of overloads

find_last_of

find_last_of overloads

front

front overloads

get_allocator

Return the allocator used by this string to supply memory.

insert

insert overloads

insert_range

Insert at the specified position in this string the characters from the specified range and return an iterator providing non‐modifiable access to the first inserted character, or a non‐`const` copy of position if true == bsl::ranges.empty(). The behavior is undefined unless position is an iterator in the range [begin() .. end()] (both endpoints included). Note that range must meet the requirements of an input range and the values from range must have a type matching or convertible to (template parameter) CHAR_TYPE>

length

Return the length of this string. Note that this number may differ from CHAR_TRAITS::length(c_str()) in case the string contains null characters. Also note that a null‐terminating character added by the c_str method is not counted in this length.

max_size

Return the maximal possible length of this string. Note that requests to create a string longer than this number of characters are guaranteed to raise a length_error exception.

operator+=

Addition assignment operators

operator[]

Subscript operators

pop_back

Erase the last character from this string. The behavior is undefined if this string is empty.

push_back

Append the specified character to this string.

rbegin

rbegin overloads

rend

rend overloads

replace

replace overloads

replace_with_range

Replace the substring in the range starting at the specified first position and ending right before the specified last position with the characters from the specified range. Return a reference providing modifiable access to this string. The behavior is undefined unless first and last are both within the range [cbegin() .. cend()]. Note that range must meet the requirements of an input range and the values from range must have a type matching or convertible to template parameter) CHAR_TYPE.

reserve

Change the capacity of this string to the specified newCapacity. Note that the capacity of a string is the maximum length it can accommodate without reallocation. The actual storage allocated may be higher.

resize

resize overloads

resize_and_overwrite

Change the length of this string to the specified newLength, erasing characters at the end if newLength < length() or appending the appropriate number of characters at the end if length() < newLength. Subsequently, invoke the specified operation passing the address of the null‐terminated buffer and the adjusted length of this string as parameters. Finally, change the length of this string to the value returned by the operation. Throw length_error if newLength > max_size(). The behavior is undefined unless the value returned by the operation is less than or equal to newLength.

rfind

rfind overloads

shrink_to_fit

Request the removal of unused capacity by causing reallocation. Note that this method has no effect if the capacity is equal to the size. Also note that if (and only if) reallocation occurs, all iterators, including the past the end iterator, and all references to the elements are invalidated.

size

Return the length of this string. Note that this number may differ from CHAR_TRAITS::length(c_str()) in case the string contains null characters. Also note that a null‐terminating character added by the c_str method is not counted in this length.

starts_with

starts_with overloads

substr

substr overloads

swap

Exchange the value of this object with that of the specified other object; also exchange the allocator of this object with that of other if the (template parameter) type ALLOCATOR has the propagate_on_container_swap trait, and do not modify either allocator otherwise. This method provides the no‐throw exception‐safety guarantee. This operation has O[1] complexity if either this object was created with the same allocator as other or ALLOCATOR has the propagate_on_container_swap trait; otherwise, it has O[n + m] complexity, where n and m are the lengths of this object and other, respectively. Note that this method`s support for swapping objects created with different allocators when ALLOCATOR does not have the propagate_on_container_swap trait is a departure from the C++ Standard.

operator BloombergLP::bslmf::NestedTraitDeclaration<basic_string<char16_t>, IsBitwiseMoveable, BloombergLP::bslmf::IsBitwiseMoveable<bsl::allocator<char16_t>>::value>

CHAR_TYPE is required to be a POD as per the Standard, which makes CHAR_TYPE bitwise‐movable, so basic_string is bitwise‐movable as long as the (template parameter) type ALLOCATOR is also bitwise‐movable.

operator basic_string_view<char16_t, char_traits<char16_t>>

Convert this object to a string_view type instantiated with the same character type and traits type. The return view will contain the same sequence of characters as this object. Note that this conversion operator can be invoked implicitly (e.g., during argument passing).

operator std::basic_string<char16_t, char_traits<char16_t>, ALLOC2>

Convert this object to a string type native to the compiler's library, instantiated with the same character type and traits type, but not necessarily the same allocator type. The return string will contain the same sequence of characters as orig and will have a default‐constructed allocator. Note that this conversion operator can be invoked implicitly (e.g., during argument passing).

Name

Description

npos

Value used to denote "not‐a‐position", guaranteed to be outside the range [0 .. max_size()].

Name

Description

bsl::String_ClearProctor

This component private class implements a proctor that sets the length of a string to zero, and, if release is not called, will restore that string upon it's destruction. The intended usage is to implement assign methods in terms of append (by clearing the string before appending to it), while maintaining the strong exceptions guarantee. Note that after constructing this proctor for a string s, the invariant s[s.length()]== CHAR_TYPE() is violated for non‐empty s. This invariant will be restored by either a successful append or by the proctor's destructor if an exception is thrown. Note that the template parameter was renamed from STRING_TYPE to FULL_STRING_TYPE due to a name clash with a define elsewhere in the code base (see DRQS 112049582).

bsl::to_string

Constructs a string with contents equal to the specified value. The contents of the string will be the same as what std::sprintf(buf, "%llu", value) would produce with a sufficiently large buffer.

bsl::to_string

Constructs a string with contents equal to the specified value. The contents of the string will be the same as what std::sprintf(buf, "%lu", value) would produce with a sufficiently large buffer.

bsl::to_string

Constructs a string with contents equal to the specified value. The contents of the string will be the same as what std::sprintf(buf, "%u", value) would produce with a sufficiently large buffer.

bsl::to_string

Constructs a string with contents equal to the specified value. The contents of the string will be the same as what std::sprintf(buf, "%lld", value) would produce with a sufficiently large buffer.

bsl::to_string

Constructs a string with contents equal to the specified value. The contents of the string will be the same as what std::sprintf(buf, "%ld", value) would produce with a sufficiently large buffer.

bsl::to_string

to_string functions are made friends to allow access to the internal short string buffer.