bsl::basic_string::erase

Synopses

Declared in <bslstl_string.h>

Erase a character at the specified position from this string, and return an iterator providing modifiable access to the character at position prior to erasing. If no such character exists, return end(). The behavior is undefined unless position is within the half-open range [cbegin() .. cend())].

iterator
erase(const_iterator position);

» more...

Erase from this string a substring defined by the specified pair of first and last iterators within this string. Return an iterator providing modifiable access to the character at the last position prior to erasing. If no such character exists, return end(). This method invalidates existing iterators pointing to first or a subsequent position. The behavior is undefined unless first and last are both within the range [cbegin() .. cend()] and `first <= last`.

iterator
erase(
    const_iterator first,
    const_iterator last);

» more...

Erase from this string the substring of length the optionally specified numChars or original.length() - position, whichever is smaller, starting at the optionally specified position. If position is not specified, the first position is used (i.e., position is set to 0). Return a reference providing modifiable access to this string. If numChars equals npos, then the remaining length of the string is erased (i.e., numChars is set to length() - position). Throw out_of_range if position > length().

basic_string&
erase(
    size_type position = 0,
    size_type numChars = npos);

» more...