libstdc++
|
Public Types | |
typedef _Allocator | allocator_type |
typedef __gnu_debug::_Safe_iterator< typename _Base::const_iterator, basic_string > | const_iterator |
typedef _Base::const_pointer | const_pointer |
typedef _Base::const_reference | const_reference |
typedef std::reverse_iterator< const_iterator > | const_reverse_iterator |
typedef _Base::difference_type | difference_type |
typedef __gnu_debug::_Safe_iterator< typename _Base::iterator, basic_string > | iterator |
typedef _Base::pointer | pointer |
typedef _Base::reference | reference |
typedef std::reverse_iterator< iterator > | reverse_iterator |
typedef _Base::size_type | size_type |
typedef _Traits | traits_type |
typedef _Traits::char_type | value_type |
Public Member Functions | |
basic_string (_Base &&__base) noexcept | |
template<typename _InputIterator > | |
basic_string (_InputIterator __begin, _InputIterator __end, const _Allocator &__a=_Allocator()) | |
basic_string (basic_string &&)=default | |
basic_string (const _Allocator &__a) noexcept | |
basic_string (const _Base &__base) | |
basic_string (const _CharT *__s, const _Allocator &__a=_Allocator()) | |
basic_string (const _CharT *__s, size_type __n, const _Allocator &__a=_Allocator()) | |
basic_string (const basic_string &)=default | |
basic_string (const basic_string &__str, size_type __pos, size_type __n=_Base::npos, const _Allocator &__a=_Allocator()) | |
basic_string (size_type __n, _CharT __c, const _Allocator &__a=_Allocator()) | |
basic_string (std::initializer_list< _CharT > __l, const _Allocator &__a=_Allocator()) | |
const _Base & | _M_base () const noexcept |
_Base & | _M_base () noexcept |
void | _M_invalidate_if (_Predicate __pred) |
basic_string< _CharT, std::char_traits< _CharT >, std::allocator< _CharT > > & | _M_replace_dispatch (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2, __false_type) |
void | _M_swap (_Safe_container &__x) noexcept |
void | _M_transfer_from_if (_Safe_sequence &__from, _Predicate __pred) |
_CharT * | _S_construct (_InIterator __beg, _InIterator __end, const std::allocator< _CharT > &__a, forward_iterator_tag) |
template<typename _InputIterator > | |
basic_string & | append (_InputIterator __first, _InputIterator __last) |
basic_string & | append (const _CharT *__s) |
basic_string & | append (const _CharT *__s, size_type __n) |
basic_string & | append (const basic_string &__str) |
basic_string & | append (const basic_string &__str) |
basic_string & | append (const basic_string &__str, size_type __pos, size_type __n) |
basic_string & | append (const basic_string &__str, size_type __pos, size_type __n=npos) |
basic_string & | append (initializer_list< _CharT > __l) |
basic_string & | append (size_type __n, _CharT __c) |
template<typename _InputIterator > | |
basic_string & | assign (_InputIterator __first, _InputIterator __last) |
basic_string & | assign (basic_string &&__str) noexcept(allocator_traits< std::allocator< _CharT > >::is_always_equal::value) |
basic_string & | assign (basic_string &&__x) noexcept(noexcept(std::declval< _Base & >().assign(std::move(__x)))) |
basic_string & | assign (const _CharT *__s) |
basic_string & | assign (const _CharT *__s, size_type __n) |
basic_string & | assign (const basic_string &__str) |
basic_string & | assign (const basic_string &__str, size_type __pos, size_type __n) |
basic_string & | assign (const basic_string &__str, size_type __pos, size_type __n=npos) |
basic_string & | assign (const basic_string &__x) |
basic_string & | assign (size_type __n, _CharT __c) |
basic_string & | assign (std::initializer_list< _CharT > __l) |
reference | at (size_type __n) |
reference | at (size_type __n) |
const_reference | at (size_type __n) const |
const_reference | at (size_type __n) const |
reference | back () |
const_reference | back () const noexcept |
iterator | begin () |
const_iterator | begin () const noexcept |
const _CharT * | c_str () const noexcept |
const _CharT * | c_str () const noexcept |
size_type | capacity () const noexcept |
const_iterator | cbegin () const noexcept |
const_iterator | cbegin () const noexcept |
const_iterator | cend () const noexcept |
const_iterator | cend () const noexcept |
void | clear () |
int | compare (const _CharT *__s) const |
int | compare (const basic_string &__str) const |
int | compare (const basic_string &__str) const |
int | compare (size_type __pos, size_type __n, const basic_string &__str) const |
int | compare (size_type __pos1, size_type __n1, const _CharT *__s) const |
int | compare (size_type __pos1, size_type __n1, const _CharT *__s, size_type __n2) const |
int | compare (size_type __pos1, size_type __n1, const basic_string &__str) const |
int | compare (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2) const |
int | compare (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2=npos) const |
size_type | copy (_CharT *__s, size_type __n, size_type __pos=0) const |
const_reverse_iterator | crbegin () const noexcept |
const_reverse_iterator | crbegin () const noexcept |
const_reverse_iterator | crend () const noexcept |
const_reverse_iterator | crend () const noexcept |
const _CharT * | data () const noexcept |
const _CharT * | data () const noexcept |
bool | empty () const noexcept |
iterator | end () |
const_iterator | end () const noexcept |
iterator | erase (iterator __first, iterator __last) |
iterator | erase (iterator __first, iterator __last) |
iterator | erase (iterator __position) |
iterator | erase (iterator __position) |
basic_string & | erase (size_type __pos=0, size_type __n=_Base::npos) |
size_type | find (_CharT __c, size_type __pos=0) const noexcept |
size_type | find (const _CharT *__s, size_type __pos, size_type __n) const |
size_type | find (const _CharT *__s, size_type __pos=0) const |
size_type | find (const basic_string &__str, size_type __pos=0) const noexcept |
size_type | find (const basic_string &__str, size_type __pos=0) const noexcept |
size_type | find_first_not_of (_CharT __c, size_type __pos=0) const noexcept |
size_type | find_first_not_of (const _CharT *__s, size_type __pos, size_type __n) const |
size_type | find_first_not_of (const _CharT *__s, size_type __pos=0) const |
size_type | find_first_not_of (const basic_string &__str, size_type __pos=0) const noexcept |
size_type | find_first_not_of (const basic_string &__str, size_type __pos=0) const noexcept |
size_type | find_first_of (_CharT __c, size_type __pos=0) const noexcept |
size_type | find_first_of (const _CharT *__s, size_type __pos, size_type __n) const |
size_type | find_first_of (const _CharT *__s, size_type __pos=0) const |
size_type | find_first_of (const basic_string &__str, size_type __pos=0) const noexcept |
size_type | find_first_of (const basic_string &__str, size_type __pos=0) const noexcept |
size_type | find_last_not_of (_CharT __c, size_type __pos=_Base::npos) const noexcept |
size_type | find_last_not_of (const _CharT *__s, size_type __pos, size_type __n) const |
size_type | find_last_not_of (const _CharT *__s, size_type __pos=_Base::npos) const |
size_type | find_last_not_of (const basic_string &__str, size_type __pos=_Base::npos) const noexcept |
size_type | find_last_not_of (const basic_string &__str, size_type __pos=npos) const noexcept |
size_type | find_last_of (_CharT __c, size_type __pos=_Base::npos) const noexcept |
size_type | find_last_of (const _CharT *__s, size_type __pos, size_type __n) const |
size_type | find_last_of (const _CharT *__s, size_type __pos=_Base::npos) const |
size_type | find_last_of (const basic_string &__str, size_type __pos=_Base::npos) const noexcept |
size_type | find_last_of (const basic_string &__str, size_type __pos=npos) const noexcept |
reference | front () |
const_reference | front () const noexcept |
allocator_type | get_allocator () const noexcept |
iterator | insert (__const_iterator __p, _CharT __c) |
template<typename _InputIterator > | |
iterator | insert (__const_iterator __p, _InputIterator __first, _InputIterator __last) |
iterator | insert (const_iterator __p, size_type __n, _CharT __c) |
iterator | insert (const_iterator __p, std::initializer_list< _CharT > __l) |
iterator | insert (iterator __p, _CharT __c) |
void | insert (iterator __p, _InputIterator __beg, _InputIterator __end) |
void | insert (iterator __p, initializer_list< _CharT > __l) |
void | insert (iterator __p, size_type __n, _CharT __c) |
basic_string & | insert (size_type __pos, const _CharT *__s) |
basic_string & | insert (size_type __pos, const _CharT *__s, size_type __n) |
basic_string & | insert (size_type __pos, size_type __n, _CharT __c) |
basic_string & | insert (size_type __pos1, const basic_string &__str) |
basic_string & | insert (size_type __pos1, const basic_string &__str) |
basic_string & | insert (size_type __pos1, const basic_string &__str, size_type __pos2, size_type __n) |
basic_string & | insert (size_type __pos1, const basic_string &__str, size_type __pos2, size_type __n=npos) |
size_type | length () const noexcept |
size_type | max_size () const noexcept |
basic_string & | operator+= (_CharT __c) |
basic_string & | operator+= (const _CharT *__s) |
basic_string & | operator+= (const basic_string &__str) |
basic_string & | operator+= (const basic_string &__str) |
basic_string & | operator+= (std::initializer_list< _CharT > __l) |
basic_string & | operator= (_CharT __c) |
basic_string & | operator= (basic_string &&)=default |
basic_string & | operator= (const _CharT *__s) |
basic_string & | operator= (const basic_string &)=default |
basic_string & | operator= (std::initializer_list< _CharT > __l) |
reference | operator[] (size_type __pos) |
const_reference | operator[] (size_type __pos) const noexcept |
void | pop_back () |
void | push_back (_CharT __c) |
reverse_iterator | rbegin () |
const_reverse_iterator | rbegin () const noexcept |
reverse_iterator | rend () |
const_reverse_iterator | rend () const noexcept |
template<typename _InputIterator > | |
basic_string & | replace (__const_iterator __i1, __const_iterator __i2, _InputIterator __j1, _InputIterator __j2) |
basic_string & | replace (__const_iterator __i1, __const_iterator __i2, const _CharT *__s) |
basic_string & | replace (__const_iterator __i1, __const_iterator __i2, const _CharT *__s, size_type __n) |
basic_string & | replace (__const_iterator __i1, __const_iterator __i2, const basic_string &__str) |
basic_string & | replace (__const_iterator __i1, __const_iterator __i2, size_type __n, _CharT __c) |
basic_string & | replace (__const_iterator __i1, __const_iterator __i2, std::initializer_list< _CharT > __l) |
basic_string & | replace (iterator __i1, iterator __i2, _CharT *__k1, _CharT *__k2) |
basic_string & | replace (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2) |
basic_string & | replace (iterator __i1, iterator __i2, const _CharT *__k1, const _CharT *__k2) |
basic_string & | replace (iterator __i1, iterator __i2, const _CharT *__s) |
basic_string & | replace (iterator __i1, iterator __i2, const _CharT *__s, size_type __n) |
basic_string & | replace (iterator __i1, iterator __i2, const basic_string &__str) |
basic_string & | replace (iterator __i1, iterator __i2, const_iterator __k1, const_iterator __k2) |
basic_string & | replace (iterator __i1, iterator __i2, initializer_list< _CharT > __l) |
basic_string & | replace (iterator __i1, iterator __i2, iterator __k1, iterator __k2) |
basic_string & | replace (iterator __i1, iterator __i2, size_type __n, _CharT __c) |
basic_string & | replace (size_type __pos, size_type __n, const basic_string &__str) |
basic_string & | replace (size_type __pos, size_type __n1, const _CharT *__s) |
basic_string & | replace (size_type __pos, size_type __n1, const _CharT *__s, size_type __n2) |
basic_string & | replace (size_type __pos, size_type __n1, size_type __n2, _CharT __c) |
basic_string & | replace (size_type __pos1, size_type __n1, const basic_string &__str) |
basic_string & | replace (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2) |
basic_string & | replace (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2=npos) |
void | reserve (size_type __res_arg=0) |
void | reserve (size_type __res_arg=0) |
void | resize (size_type __n) |
void | resize (size_type __n, _CharT __c) |
size_type | rfind (_CharT __c, size_type __pos=_Base::npos) const noexcept |
size_type | rfind (const _CharT *__s, size_type __pos, size_type __n) const |
size_type | rfind (const _CharT *__s, size_type __pos=_Base::npos) const |
size_type | rfind (const basic_string &__str, size_type __pos=_Base::npos) const noexcept |
size_type | rfind (const basic_string &__str, size_type __pos=npos) const noexcept |
void | shrink_to_fit () noexcept |
size_type | size () const noexcept |
basic_string | substr (size_type __pos=0, size_type __n=_Base::npos) const |
void | swap (basic_string &__s) noexcept(/*conditional */) |
void | swap (basic_string &__x) noexcept(/*conditional */) |
Static Public Attributes | |
static const size_type | npos |
Protected Member Functions | |
_Safe_container & | _M_safe () noexcept |
Friends | |
template<typename _ItT , typename _SeqT , typename _CatT > | |
class | ::__gnu_debug::_Safe_iterator |
Class std::basic_string with safety/checking/debug instrumentation.
Definition at line 86 of file debug/string.
|
inherited |
Invalidates all iterators x
that reference this sequence, are not singular, and for which __pred(x)
returns true
. __pred
will be invoked with the normal iterators nested in the safe ones.
Definition at line 38 of file safe_sequence.tcc.
|
inherited |
Transfers all iterators x
that reference from
sequence, are not singular, and for which __pred(x)
returns true
. __pred
will be invoked with the normal iterators nested in the safe ones.
Definition at line 69 of file safe_sequence.tcc.
|
inherited |
Append a string to this string.
__str | The string to append. |
Definition at line 777 of file basic_string.tcc.
|
inherited |
Append a substring.
__str | The string to append. |
__pos | Index of the first character of str to append. |
__n | The number of characters to append. |
std::out_of_range | if __pos is not a valid index. |
This function appends __n characters from __str starting at __pos to this string. If __n is is larger than the number of available characters in __str, the remainder of __str is appended.
Definition at line 794 of file basic_string.tcc.
|
inlineinherited |
Append an initializer_list of characters.
__l | The initializer_list of characters to append. |
Definition at line 4266 of file basic_string.h.
|
inlinenoexceptinherited |
Set value to contents of another string.
__str | Source string to use. |
This function sets this string to the exact contents of __str. __str is a valid, but unspecified string.
Definition at line 4348 of file basic_string.h.
|
inherited |
Set value to contents of another string.
__str | Source string to use. |
Definition at line 695 of file basic_string.tcc.
|
inlineinherited |
Set value to a substring of a string.
__str | The string to use. |
__pos | Index of the first character of str. |
__n | Number of characters to use. |
std::out_of_range | if pos is not a valid index. |
This function sets this string to the substring of __str consisting of __n characters at __pos. If __n is is larger than the number of available characters in __str, the remainder of __str is used.
Definition at line 4370 of file basic_string.h.
|
inline |
Provides access to the data contained in the string.
__n | The index of the character to access. |
std::out_of_range | If n is an invalid index. |
This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails. Success results in unsharing the string.
Definition at line 4092 of file basic_string.h.
|
inlineinherited |
Provides access to the data contained in the string.
__n | The index of the character to access. |
std::out_of_range | If n is an invalid index. |
This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails. Success results in unsharing the string.
Definition at line 4092 of file basic_string.h.
|
inline |
Provides access to the data contained in the string.
__n | The index of the character to access. |
std::out_of_range | If n is an invalid index. |
This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails.
Definition at line 4070 of file basic_string.h.
|
inlineinherited |
Provides access to the data contained in the string.
__n | The index of the character to access. |
std::out_of_range | If n is an invalid index. |
This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails.
Definition at line 4070 of file basic_string.h.
|
inline |
Returns a read/write reference to the data at the last element of the string.
Definition at line 4131 of file basic_string.h.
|
inlinenoexcept |
Returns a read-only (constant) reference to the data at the last element of the string.
Definition at line 4142 of file basic_string.h.
|
inlinenoexceptinherited |
Return const pointer to null-terminated contents.
This is a handle to internal data. Do not modify or dire things may happen.
Definition at line 5197 of file basic_string.h.
|
inlinenoexcept |
Returns the total number of characters that the string can hold before needing to allocate more memory.
Definition at line 3966 of file basic_string.h.
|
inlinenoexceptinherited |
Returns a read-only (constant) iterator that points to the first character in the string.
Definition at line 3868 of file basic_string.h.
|
inlinenoexceptinherited |
Returns a read-only (constant) iterator that points one past the last character in the string.
Definition at line 3876 of file basic_string.h.
|
inlineinherited |
Compare to a string.
__str | String to compare against. |
Returns an integer < 0 if this string is ordered before __str, 0 if their values are equivalent, or > 0 if this string is ordered after __str. Determines the effective length rlen of the strings to compare as the smallest of size() and str.size(). The function then compares the two strings by calling traits::compare(data(), str.data(),rlen). If the result of the comparison is nonzero returns it, otherwise the shorter one is ordered first.
Definition at line 5753 of file basic_string.h.
|
inherited |
Compare substring to a string.
__pos | Index of first character of substring. |
__n | Number of characters in substring. |
__str | String to compare against. |
Form the substring of this string from the __n characters starting at __pos. Returns an integer < 0 if the substring is ordered before __str, 0 if their values are equivalent, or > 0 if the substring is ordered after __str. Determines the effective length rlen of the strings to compare as the smallest of the length of the substring and __str.size(). The function then compares the two strings by calling traits::compare(substring.data(),str.data(),rlen). If the result of the comparison is nonzero returns it, otherwise the shorter one is ordered first.
Definition at line 1396 of file basic_string.tcc.
|
inherited |
Compare substring to a substring.
__pos1 | Index of first character of substring. |
__n1 | Number of characters in substring. |
__str | String to compare against. |
__pos2 | Index of first character of substring of str. |
__n2 | Number of characters in substring of str. |
Form the substring of this string from the __n1 characters starting at __pos1. Form the substring of __str from the __n2 characters starting at __pos2. Returns an integer < 0 if this substring is ordered before the substring of __str, 0 if their values are equivalent, or > 0 if this substring is ordered after the substring of __str. Determines the effective length rlen of the strings to compare as the smallest of the lengths of the substrings. The function then compares the two strings by calling traits::compare(substring.data(),str.substr(pos2,n2).data(),rlen). If the result of the comparison is nonzero returns it, otherwise the shorter one is ordered first.
Definition at line 1411 of file basic_string.tcc.
|
inlinenoexceptinherited |
Returns a read-only (constant) reverse iterator that points to the last character in the string. Iteration is done in reverse element order.
Definition at line 3885 of file basic_string.h.
|
inlinenoexceptinherited |
Returns a read-only (constant) reverse iterator that points to one before the first character in the string. Iteration is done in reverse element order.
Definition at line 3894 of file basic_string.h.
|
inlinenoexceptinherited |
Return const pointer to contents.
This is a pointer to internal data. It is undefined to modify the contents through the returned pointer. To get a pointer that allows modifying the contents use &str
[0] instead, (or in C++17 the non-const str.data()
overload).
Definition at line 5209 of file basic_string.h.
|
inlinenoexcept |
Returns true if the string is empty. Equivalent to *this == ""
.
Definition at line 4016 of file basic_string.h.
|
inherited |
Remove a range of characters.
__first | Iterator referencing the first character to remove. |
__last | Iterator referencing the end of the range. |
Removes the characters in the range [first,last) from this string. The value of the string doesn't change if an error is thrown.
Definition at line 843 of file basic_string.tcc.
|
inlineinherited |
Remove one character.
__position | Iterator referencing the character to remove. |
Removes the character at __position from this string. The value of the string doesn't change if an error is thrown.
Definition at line 4716 of file basic_string.h.
|
inlinenoexceptinherited |
Find position of a string.
__str | String to locate. |
__pos | Index of character to search from (default 0). |
Starting from __pos, searches forward for value of __str within this string. If found, returns the index where it begins. If not found, returns npos.
Definition at line 5261 of file basic_string.h.
|
inlinenoexceptinherited |
Find position of a character not in string.
__str | String containing characters to avoid. |
__pos | Index of character to search from (default 0). |
Starting from __pos, searches forward for a character not contained in __str within this string. If found, returns the index where it was found. If not found, returns npos.
Definition at line 5569 of file basic_string.h.
|
inlinenoexceptinherited |
Find position of a character of string.
__str | String containing characters to locate. |
__pos | Index of character to search from (default 0). |
Starting from __pos, searches forward for one of the characters of __str within this string. If found, returns the index where it was found. If not found, returns npos.
Definition at line 5402 of file basic_string.h.
|
inlinenoexceptinherited |
Find last position of a character not in string.
__str | String containing characters to avoid. |
__pos | Index of character to search back from (default end). |
Starting from __pos, searches backward for a character not contained in __str within this string. If found, returns the index where it was found. If not found, returns npos.
Definition at line 5651 of file basic_string.h.
|
inlinenoexceptinherited |
Find last position of a character of string.
__str | String containing characters to locate. |
__pos | Index of character to search back from (default end). |
Starting from __pos, searches backward for one of the characters of __str within this string. If found, returns the index where it was found. If not found, returns npos.
Definition at line 5486 of file basic_string.h.
|
inline |
Returns a read/write reference to the data at the first element of the string.
Definition at line 4109 of file basic_string.h.
|
inlinenoexcept |
Returns a read-only (constant) reference to the data at the first element of the string.
Definition at line 4120 of file basic_string.h.
|
inlinenoexcept |
Return copy of allocator used to construct this string.
Definition at line 5231 of file basic_string.h.
|
inlineinherited |
Insert one character.
__p | Iterator referencing position in string to insert at. |
__c | The character to insert. |
std::length_error | If new length exceeds max_size() . |
Inserts character __c at position referenced by __p. If adding character causes the length to exceed max_size(), length_error is thrown. If __p is beyond end of string, out_of_range is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4639 of file basic_string.h.
|
inlineinherited |
Insert a range of characters.
__p | Iterator referencing location in string to insert at. |
__beg | Start of range. |
__end | End of range. |
std::length_error | If new length exceeds max_size() . |
Inserts characters in range [__beg,__end). If adding characters causes the length to exceed max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4504 of file basic_string.h.
|
inlineinherited |
Insert an initializer_list of characters.
__p | Iterator referencing location in string to insert at. |
__l | The initializer_list of characters to insert. |
std::length_error | If new length exceeds max_size() . |
Definition at line 4515 of file basic_string.h.
|
inlineinherited |
Insert multiple characters.
__p | Iterator referencing location in string to insert at. |
__n | Number of characters to insert |
__c | The character to insert. |
std::length_error | If new length exceeds max_size() . |
Inserts __n copies of character __c starting at the position referenced by iterator __p. If adding characters causes the length to exceed max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4487 of file basic_string.h.
|
inlineinherited |
Insert value of a string.
__pos1 | Position in string to insert at. |
__str | The string to insert. |
std::length_error | If new length exceeds max_size() . |
Inserts value of __str starting at __pos1. If adding characters causes the length to exceed max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4535 of file basic_string.h.
|
inlineinherited |
Insert a substring.
__pos1 | Position in string to insert at. |
__str | The string to insert. |
__pos2 | Start of characters in str to insert. |
__n | Number of characters to insert. |
std::length_error | If new length exceeds max_size() . |
std::out_of_range | If pos1 > size() or __pos2 > str.size(). |
Starting at pos1, insert __n character of __str beginning with __pos2. If adding characters causes the length to exceed max_size(), length_error is thrown. If __pos1 is beyond the end of this string or __pos2 is beyond the end of __str, out_of_range is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4557 of file basic_string.h.
|
inlinenoexcept |
Returns the number of characters in the string, not including any null-termination.
Definition at line 3909 of file basic_string.h.
|
inlinenoexcept |
Returns the size() of the largest possible string.
Definition at line 3914 of file basic_string.h.
|
inlineinherited |
Append a string to this string.
__str | The string to append. |
Definition at line 4156 of file basic_string.h.
|
inlineinherited |
Replace range of characters with range.
__i1 | Iterator referencing start of range to replace. |
__i2 | Iterator referencing end of range to replace. |
__k1 | Iterator referencing start of range to insert. |
__k2 | Iterator referencing end of range to insert. |
std::length_error | If new length exceeds max_size() . |
Removes the characters in the range [__i1,__i2). In place, characters in the range [__k1,__k2) are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4964 of file basic_string.h.
|
inlineinherited |
Replace range of characters with C string.
__i1 | Iterator referencing start of range to replace. |
__i2 | Iterator referencing end of range to replace. |
__s | C string value to insert. |
std::length_error | If new length exceeds max_size() . |
Removes the characters in the range [__i1,__i2). In place, the characters of __s are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4919 of file basic_string.h.
|
inlineinherited |
Replace range of characters with C substring.
__i1 | Iterator referencing start of range to replace. |
__i2 | Iterator referencing end of range to replace. |
__s | C string value to insert. |
__n | Number of characters from s to insert. |
std::length_error | If new length exceeds max_size() . |
Removes the characters in the range [__i1,__i2). In place, the first __n characters of __s are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4898 of file basic_string.h.
|
inlineinherited |
Replace range of characters with string.
__i1 | Iterator referencing start of range to replace. |
__i2 | Iterator referencing end of range to replace. |
__str | String value to insert. |
std::length_error | If new length exceeds max_size() . |
Removes the characters in the range [__i1,__i2). In place, the value of __str is inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4879 of file basic_string.h.
|
inlineinherited |
Replace range of characters with initializer_list.
__i1 | Iterator referencing start of range to replace. |
__i2 | Iterator referencing end of range to replace. |
__l | The initializer_list of characters to insert. |
std::length_error | If new length exceeds max_size() . |
Removes the characters in the range [__i1,__i2). In place, characters in the range [__k1,__k2) are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 5033 of file basic_string.h.
|
inlineinherited |
Replace range of characters with multiple characters.
__i1 | Iterator referencing start of range to replace. |
__i2 | Iterator referencing end of range to replace. |
__n | Number of characters to insert. |
__c | Character to insert. |
std::length_error | If new length exceeds max_size() . |
Removes the characters in the range [__i1,__i2). In place, __n copies of __c are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4940 of file basic_string.h.
|
inlineinherited |
Replace characters with value from another string.
__pos | Index of first character to replace. |
__n | Number of characters to be replaced. |
__str | String to insert. |
std::out_of_range | If pos is beyond the end of this string. |
std::length_error | If new length exceeds max_size() . |
Removes the characters in the range [__pos,__pos+__n) from this string. In place, the value of __str is inserted. If __pos is beyond end of string, out_of_range is thrown. If the length of the result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4770 of file basic_string.h.
|
inlineinherited |
Replace characters with value from another string.
__pos1 | Index of first character to replace. |
__n1 | Number of characters to be replaced. |
__str | String to insert. |
__pos2 | Index of first character of str to use. |
__n2 | Number of characters from str to use. |
std::out_of_range | If __pos1 > size() or __pos2 > __str.size(). |
std::length_error | If new length exceeds max_size() . |
Removes the characters in the range [__pos1,__pos1 + n) from this string. In place, the value of __str is inserted. If __pos is beyond end of string, out_of_range is thrown. If the length of the result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
Definition at line 4792 of file basic_string.h.
void std::basic_string< _CharT, _Traits, _Alloc >::reserve |
Attempt to preallocate enough memory for specified number of characters.
__res_arg | Number of characters required. |
std::length_error | If __res_arg exceeds max_size() . |
This function attempts to reserve enough memory for the string to hold the specified number of characters. If the number requested is more than max_size(), length_error is thrown.
The advantage of this function is that if optimal code is a necessity and the user can determine the string length that will be required, the user can reserve the memory in advance, and thus prevent a possible reallocation of memory and copying of string data.
Definition at line 954 of file basic_string.tcc.
|
inherited |
Attempt to preallocate enough memory for specified number of characters.
__res_arg | Number of characters required. |
std::length_error | If __res_arg exceeds max_size() . |
This function attempts to reserve enough memory for the string to hold the specified number of characters. If the number requested is more than max_size(), length_error is thrown.
The advantage of this function is that if optimal code is a necessity and the user can determine the string length that will be required, the user can reserve the memory in advance, and thus prevent a possible reallocation of memory and copying of string data.
Definition at line 954 of file basic_string.tcc.
|
inlinenoexceptinherited |
Find last position of a string.
__str | String to locate. |
__pos | Index of character to search back from (default end). |
Starting from __pos, searches backward for value of __str within this string. If found, returns the index where it begins. If not found, returns npos.
Definition at line 5323 of file basic_string.h.
|
inlinenoexcept |
Returns the number of characters in the string, not including any null-termination.
Definition at line 3903 of file basic_string.h.
|
noexceptinherited |
Swap contents with another string.
__s | String to swap with. |
Exchanges the contents of this string with that of __s in constant time.
Definition at line 971 of file basic_string.tcc.
|
static |
Value returned by various member functions when they fail.
Definition at line 3353 of file basic_string.h.