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 (basic_string &&__s, const _Allocator &__a) noexcept(std::is_nothrow_constructible< _Base, _Base, const _Allocator & >::value) | |
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 &__s, const _Allocator &__a) | |
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 |
template<typename _InputIterator > | |
basic_string< _CharT, _Traits, _Alloc > & | _M_replace_dispatch (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2, __false_type) |
void | _M_swap (_Safe_container &__x) noexcept |
template<typename _InIterator > | |
_CharT * | _S_construct (_InIterator __beg, _InIterator __end, const _Alloc &__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) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | append (const _Tp &__svt) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | append (const _Tp &__svt, size_type __pos, size_type __n=npos) |
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< _Alloc >::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) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | assign (const _Tp &__svt) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | assign (const _Tp &__svt, size_type __pos, size_type __n=npos) |
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) |
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 |
size_type | capacity () const noexcept |
const_iterator | cbegin () const noexcept |
const_iterator | cend () const noexcept |
void | clear () |
int | compare (const _CharT *__s) const |
template<typename _Tp > | |
_If_sv< _Tp, int > | compare (const _Tp &__svt) const noexcept(is_same< _Tp, __sv_type >::value) |
int | compare (const basic_string &__str) const |
int | compare (const basic_string &__str) const |
template<typename _Tp > | |
_If_sv< _Tp, int > | compare (size_type __pos, size_type __n, const _Tp &__svt) const noexcept(is_same< _Tp, __sv_type >::value) |
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 |
template<typename _Tp > | |
_If_sv< _Tp, int > | compare (size_type __pos1, size_type __n1, const _Tp &__svt, size_type __pos2, size_type __n2=npos) const noexcept(is_same< _Tp, __sv_type >::value) |
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 | crend () const noexcept |
const _CharT * | data () const noexcept |
_CharT * | data () noexcept |
bool | empty () const noexcept |
iterator | end () |
const_iterator | end () const noexcept |
iterator | erase (__const_iterator __first, __const_iterator __last) |
iterator | erase (__const_iterator __position) |
iterator | erase (iterator __first, iterator __last) |
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 |
template<typename _Tp > | |
_If_sv< _Tp, size_type > | find (const _Tp &__svt, size_type __pos=0) const noexcept(is_same< _Tp, __sv_type >::value) |
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 |
template<typename _Tp > | |
_If_sv< _Tp, size_type > | find_first_not_of (const _Tp &__svt, size_type __pos=0) const noexcept(is_same< _Tp, __sv_type >::value) |
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 |
template<typename _Tp > | |
_If_sv< _Tp, size_type > | find_first_of (const _Tp &__svt, size_type __pos=0) const noexcept(is_same< _Tp, __sv_type >::value) |
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 |
template<typename _Tp > | |
_If_sv< _Tp, size_type > | find_last_not_of (const _Tp &__svt, size_type __pos=npos) const noexcept(is_same< _Tp, __sv_type >::value) |
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 |
template<typename _Tp > | |
_If_sv< _Tp, size_type > | find_last_of (const _Tp &__svt, size_type __pos=npos) const noexcept(is_same< _Tp, __sv_type >::value) |
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) |
template<class _InputIterator > | |
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) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | insert (size_type __pos, const _Tp &__svt) |
basic_string & | insert (size_type __pos, size_type __n, _CharT __c) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | insert (size_type __pos1, const _Tp &__svt, size_type __pos2, size_type __n=npos) |
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 |
operator __sv_type () const noexcept | |
basic_string & | operator+= (_CharT __c) |
basic_string & | operator+= (const _CharT *__s) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | operator+= (const _Tp &__svt) |
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) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | replace (const_iterator __i1, const_iterator __i2, const _Tp &__svt) |
basic_string & | replace (iterator __i1, iterator __i2, _CharT *__k1, _CharT *__k2) |
template<class _InputIterator > | |
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) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | replace (size_type __pos, size_type __n, const _Tp &__svt) |
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) |
template<typename _Tp > | |
_If_sv< _Tp, basic_string & > | replace (size_type __pos1, size_type __n1, const _Tp &__svt, size_type __pos2, size_type __n2=npos) |
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 () |
void | reserve (size_type __res_arg) |
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 |
template<typename _Tp > | |
_If_sv< _Tp, size_type > | rfind (const _Tp &__svt, size_type __pos=npos) const noexcept(is_same< _Tp, __sv_type >::value) |
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 94 of file debug/string.
typedef _Allocator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::allocator_type |
Definition at line 116 of file debug/string.
typedef __gnu_debug::_Safe_iterator< typename _Base::const_iterator, basic_string> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::const_iterator |
Definition at line 127 of file debug/string.
typedef _Base::const_pointer __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::const_pointer |
Definition at line 122 of file debug/string.
typedef _Base::const_reference __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::const_reference |
Definition at line 120 of file debug/string.
typedef std::reverse_iterator<const_iterator> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::const_reverse_iterator |
Definition at line 130 of file debug/string.
typedef _Base::difference_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::difference_type |
Definition at line 118 of file debug/string.
typedef __gnu_debug::_Safe_iterator< typename _Base::iterator, basic_string> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::iterator |
Definition at line 125 of file debug/string.
typedef _Base::pointer __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::pointer |
Definition at line 121 of file debug/string.
typedef _Base::reference __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::reference |
Definition at line 119 of file debug/string.
typedef std::reverse_iterator<iterator> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::reverse_iterator |
Definition at line 129 of file debug/string.
typedef _Base::size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::size_type |
Definition at line 117 of file debug/string.
typedef _Traits __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::traits_type |
Definition at line 114 of file debug/string.
typedef _Traits::char_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::value_type |
Definition at line 115 of file debug/string.
|
inlineexplicitnoexcept |
Definition at line 137 of file debug/string.
|
inline |
Definition at line 152 of file debug/string.
|
inline |
Definition at line 157 of file debug/string.
|
inlinenoexcept |
Definition at line 160 of file debug/string.
|
inlinenoexcept |
Definition at line 170 of file debug/string.
|
inline |
Definition at line 175 of file debug/string.
|
inline |
Definition at line 180 of file debug/string.
|
inline |
Definition at line 185 of file debug/string.
|
inline |
Definition at line 189 of file debug/string.
|
inline |
Definition at line 193 of file debug/string.
|
inline |
Definition at line 198 of file debug/string.
|
inlinenoexcept |
Definition at line 1068 of file debug/string.
|
inlinenoexcept |
Definition at line 1065 of file debug/string.
|
inherited |
Definition at line 1095 of file basic_string.tcc.
|
inlineprotectednoexceptinherited |
Definition at line 52 of file safe_container.h.
|
inlinenoexceptinherited |
Definition at line 111 of file safe_container.h.
|
inherited |
Definition at line 595 of file basic_string.tcc.
|
inline |
Definition at line 458 of file debug/string.
|
inline |
Definition at line 440 of file debug/string.
|
inline |
Definition at line 431 of file debug/string.
|
inlineinherited |
Append a string_view.
__svt | The object convertible to string_view to be appended. |
Definition at line 4351 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
|
inlineinherited |
Append a range of characters from a string_view.
__svt | The object convertible to string_view to be appended from. |
__pos | The position in the string_view to append from. |
__n | The number of characters to append from the string_view. |
Definition at line 4367 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
|
inherited |
Append a string to this string.
__str | The string to append. |
Definition at line 755 of file basic_string.tcc.
References std::basic_string< _CharT, _Traits, _Alloc >::size(), and std::size().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::append(), std::basic_string< _CharT, _Traits, _Alloc >::append(), std::basic_string< _CharT, _Traits, _Alloc >::append(), std::basic_string< _CharT, _Traits, _Alloc >::append(), std::collate< _CharT >::do_transform(), std::basic_string< _CharT, _Traits, _Alloc >::operator+=(), std::basic_string< _CharT, _Traits, _Alloc >::operator+=(), std::basic_string< _CharT, _Traits, _Alloc >::operator+=(), std::basic_string< _CharT, _Traits, _Alloc >::operator+=(), and std::operator>>().
|
inline |
Definition at line 415 of file debug/string.
|
inline |
Definition at line 423 of file debug/string.
|
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 772 of file basic_string.tcc.
References std::size().
|
inlineinherited |
Append an initializer_list of characters.
__l | The initializer_list of characters to append. |
Definition at line 4326 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
|
inline |
Definition at line 449 of file debug/string.
|
inline |
Definition at line 537 of file debug/string.
|
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 4408 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::swap().
|
inlinenoexcept |
Definition at line 492 of file debug/string.
|
inline |
Definition at line 519 of file debug/string.
|
inline |
Definition at line 510 of file debug/string.
|
inlineinherited |
Set value from a string_view.
__svt | The source object convertible to string_view. |
Definition at line 4509 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::assign().
|
inlineinherited |
Set value from a range of characters in a string_view.
__svt | The source object convertible to string_view. |
__pos | The position in the string_view to assign from. |
__n | The number of characters to assign. |
Definition at line 4524 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::assign().
|
inherited |
Set value to contents of another string.
__str | Source string to use. |
Definition at line 673 of file basic_string.tcc.
References std::basic_string< _CharT, _Traits, _Alloc >::get_allocator().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::operator=(), std::basic_string< _CharT, _Traits, _Alloc >::operator=(), std::basic_string< _CharT, _Traits, _Alloc >::operator=(), std::basic_string< _CharT, _Traits, _Alloc >::operator=(), std::basic_string< _CharT, _Traits, _Alloc >::operator=(), and std::basic_stringbuf< _CharT, _Traits, _Alloc >::overflow().
|
inline |
Definition at line 502 of file debug/string.
|
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 4430 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::assign().
|
inline |
Definition at line 483 of file debug/string.
|
inline |
Definition at line 528 of file debug/string.
|
inline |
Definition at line 554 of file debug/string.
|
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 4152 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 4130 of file basic_string.h.
|
inline |
Returns a read/write reference to the data at the last element of the string.
Definition at line 4191 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 4202 of file basic_string.h.
|
inline |
Definition at line 249 of file debug/string.
|
inlinenoexcept |
Definition at line 253 of file debug/string.
|
inlinenoexcept |
Definition at line 862 of file debug/string.
|
inlinenoexcept |
Returns the total number of characters that the string can hold before needing to allocate more memory.
Definition at line 4019 of file basic_string.h.
|
inlinenoexcept |
Definition at line 282 of file debug/string.
|
inlinenoexcept |
Definition at line 286 of file debug/string.
|
inline |
Definition at line 335 of file debug/string.
|
inline |
Definition at line 1039 of file debug/string.
|
inlinenoexceptinherited |
Compare to a string_view.
__svt | An object convertible to string_view to compare against. |
Definition at line 5832 of file basic_string.h.
References std::min(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
|
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 5812 of file basic_string.h.
References std::min(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
|
inline |
Definition at line 1025 of file debug/string.
|
inlinenoexceptinherited |
Compare to a string_view.
__pos | A position in the string to start comparing from. |
__n | The number of characters to compare. |
__svt | An object convertible to string_view to compare against. |
Definition at line 5856 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 1404 of file basic_string.tcc.
References std::basic_string< _CharT, _Traits, _Alloc >::data(), std::min(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
|
inline |
Definition at line 1048 of file debug/string.
|
inline |
Definition at line 1057 of file debug/string.
|
inlinenoexceptinherited |
Compare to a string_view.
__pos1 | A position in the string to start comparing from. |
__n1 | The number of characters to compare. |
__svt | An object convertible to string_view to compare against. |
__pos2 | A position in the string_view to start comparing from. |
__n2 | The number of characters to compare. |
Definition at line 5875 of file basic_string.h.
|
inline |
Definition at line 1029 of file debug/string.
|
inline |
Definition at line 1034 of file debug/string.
|
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 1419 of file basic_string.tcc.
References std::basic_string< _CharT, _Traits, _Alloc >::data(), and std::min().
|
inline |
Definition at line 846 of file debug/string.
|
inlinenoexcept |
Definition at line 290 of file debug/string.
|
inlinenoexcept |
Definition at line 294 of file debug/string.
|
inlinenoexcept |
Definition at line 870 of file debug/string.
|
inlinenoexceptinherited |
Return non-const pointer to contents.
This is a pointer to the character sequence held by the string. Modifying the characters in the sequence is allowed.
Definition at line 5279 of file basic_string.h.
|
inlinenoexcept |
Returns true if the string is empty. Equivalent to *this == ""
.
Definition at line 4076 of file basic_string.h.
|
inline |
Definition at line 257 of file debug/string.
|
inlinenoexcept |
Definition at line 261 of file debug/string.
|
inline |
Definition at line 705 of file debug/string.
|
inline |
Definition at line 696 of file debug/string.
|
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 821 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 4775 of file basic_string.h.
|
inline |
Definition at line 688 of file debug/string.
|
inlinenoexcept |
Definition at line 899 of file debug/string.
|
inline |
Definition at line 885 of file debug/string.
|
inline |
Definition at line 892 of file debug/string.
|
inlinenoexceptinherited |
Find position of a string_view.
__svt | The object convertible to string_view to locate. |
__pos | Index of character to search from (default 0). |
Definition at line 5363 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find().
|
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 5320 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find().
|
inlinenoexcept |
Definition at line 880 of file debug/string.
|
inlinenoexcept |
Definition at line 992 of file debug/string.
|
inline |
Definition at line 978 of file debug/string.
|
inline |
Definition at line 985 of file debug/string.
|
inlinenoexceptinherited |
Find position of a character not in a string_view.
__svt | An object convertible to string_view containing characters to avoid. |
__pos | Index of character to search from (default 0). |
Definition at line 5690 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of().
|
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 5628 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of(), std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of().
|
inlinenoexcept |
Definition at line 973 of file debug/string.
|
inlinenoexcept |
Definition at line 945 of file debug/string.
|
inline |
Definition at line 931 of file debug/string.
|
inline |
Definition at line 938 of file debug/string.
|
inlinenoexceptinherited |
Find position of a character of a string_view.
__svt | An object convertible to string_view containing characters to locate. |
__pos | Index of character to search from (default 0). |
Definition at line 5525 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find_first_of().
|
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 5461 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find_first_of().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_first_of(), std::basic_string< _CharT, _Traits, _Alloc >::find_first_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_first_of().
|
inlinenoexcept |
Definition at line 926 of file debug/string.
|
inlinenoexcept |
Definition at line 1016 of file debug/string.
|
inline |
Definition at line 1002 of file debug/string.
|
inline |
Definition at line 1009 of file debug/string.
|
inlinenoexceptinherited |
Find last position of a character not in a string_view.
__svt | An object convertible to string_view containing characters to avoid. |
__pos | Index of character to search back from (default end). |
Definition at line 5772 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of().
|
inlinenoexcept |
Definition at line 996 of file debug/string.
|
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 5710 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of(), std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of().
|
inlinenoexcept |
Definition at line 968 of file debug/string.
|
inline |
Definition at line 954 of file debug/string.
|
inline |
Definition at line 961 of file debug/string.
|
inlinenoexceptinherited |
Find last position of a character of string.
__svt | An object convertible to string_view containing characters to locate. |
__pos | Index of character to search back from (default end). |
Definition at line 5609 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find_last_of().
|
inlinenoexcept |
Definition at line 949 of file debug/string.
|
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 5545 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::find_last_of().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_last_of().
|
inline |
Returns a read/write reference to the data at the first element of the string.
Definition at line 4169 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 4180 of file basic_string.h.
|
inlinenoexcept |
Return copy of allocator used to construct this string.
Definition at line 5290 of file basic_string.h.
|
inline |
Definition at line 606 of file debug/string.
|
inline |
Definition at line 641 of file debug/string.
|
inline |
Definition at line 616 of file debug/string.
|
inline |
Definition at line 672 of file debug/string.
|
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 4699 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 4564 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
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 4575 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::insert().
|
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 4547 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), and std::basic_string< _CharT, _Traits, _Alloc >::insert().
|
inline |
Definition at line 589 of file debug/string.
|
inline |
Definition at line 580 of file debug/string.
|
inlineinherited |
Insert a string_view.
__pos | Position in string to insert at. |
__svt | The object convertible to string_view to insert. |
Definition at line 4717 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::insert().
|
inline |
Definition at line 598 of file debug/string.
|
inlineinherited |
Insert a string_view.
__pos1 | Position in string to insert at. |
__svt | The object convertible to string_view to insert from. |
__pos2 | Position in string_view to insert from. |
__n | The number of characters to insert. |
Definition at line 4733 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
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 4595 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::insert().
|
inline |
Definition at line 563 of file debug/string.
|
inline |
Definition at line 571 of file debug/string.
|
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 4617 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::insert().
|
inlinenoexcept |
Returns the number of characters in the string, not including any null-termination.
Definition at line 3969 of file basic_string.h.
|
inlinenoexcept |
Returns the size() of the largest possible string.
Definition at line 3974 of file basic_string.h.
|
inlinenoexceptinherited |
Convert to a string_view.
Definition at line 3843 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::data(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
|
inline |
Definition at line 397 of file debug/string.
|
inline |
Definition at line 388 of file debug/string.
|
inlineinherited |
Append a string_view.
__svt | The object convertible to string_view to be appended. |
Definition at line 4259 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
|
inlineinherited |
Append a string to this string.
__str | The string to append. |
Definition at line 4216 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
|
inline |
Definition at line 380 of file debug/string.
|
inline |
Definition at line 406 of file debug/string.
|
inline |
Definition at line 230 of file debug/string.
|
inline |
Definition at line 221 of file debug/string.
|
inline |
Definition at line 239 of file debug/string.
|
inline |
Definition at line 356 of file debug/string.
|
inlinenoexcept |
Definition at line 345 of file debug/string.
|
inline |
Definition at line 718 of file debug/string.
|
inline |
Definition at line 476 of file debug/string.
|
inline |
Definition at line 265 of file debug/string.
|
inlinenoexcept |
Definition at line 269 of file debug/string.
|
inline |
Definition at line 273 of file debug/string.
|
inlinenoexcept |
Definition at line 277 of file debug/string.
|
inline |
Definition at line 814 of file debug/string.
|
inline |
Definition at line 792 of file debug/string.
|
inline |
Definition at line 781 of file debug/string.
|
inline |
Definition at line 771 of file debug/string.
|
inline |
Definition at line 803 of file debug/string.
|
inline |
Definition at line 835 of file debug/string.
|
inlineinherited |
Replace range of characters with string_view.
__i1 | An iterator referencing the start position to replace at. |
__i2 | An iterator referencing the end position for the replace. |
__svt | The object convertible to string_view to insert from. |
Definition at line 5145 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::begin(), and std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
inlineinherited |
Definition at line 5036 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 5023 of file basic_string.h.
|
inlineinherited |
Definition at line 5046 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 4978 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
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 4957 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
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 4938 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
inlineinherited |
Definition at line 5067 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 5092 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
inlineinherited |
Definition at line 5057 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 4999 of file basic_string.h.
|
inlineinherited |
Replace range of characters with string_view.
__pos | The position to replace at. |
__n | The number of characters to replace. |
__svt | The object convertible to string_view to insert. |
Definition at line 5107 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
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 4829 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::append(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), and std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
inline |
Definition at line 754 of file debug/string.
|
inline |
Definition at line 744 of file debug/string.
|
inline |
Definition at line 763 of file debug/string.
|
inlineinherited |
Replace range of characters with string_view.
__pos1 | The position to replace at. |
__n1 | The number of characters to replace. |
__svt | The object convertible to string_view to insert from. |
__pos2 | The position in the string_view to insert from. |
__n2 | The number of characters to insert. |
Definition at line 5124 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
|
inline |
Definition at line 727 of file debug/string.
|
inline |
Definition at line 735 of file debug/string.
|
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 4851 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
void std::basic_string< _CharT, _Traits, _Alloc >::reserve |
Equivalent to shrink_to_fit().
Definition at line 4047 of file basic_string.tcc.
void std::basic_string< _CharT, _Traits, _Alloc >::reserve | ( | size_type | __res_arg | ) |
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 4040 of file basic_string.tcc.
|
inline |
Definition at line 311 of file debug/string.
|
inline |
Definition at line 304 of file debug/string.
|
inlinenoexcept |
Definition at line 922 of file debug/string.
|
inline |
Definition at line 908 of file debug/string.
|
inline |
Definition at line 915 of file debug/string.
|
inlinenoexceptinherited |
Find last position of a string_view.
__svt | The object convertible to string_view to locate. |
__pos | Index of character to search back from (default end). |
Definition at line 5441 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::rfind().
|
inlinenoexcept |
Definition at line 903 of file debug/string.
|
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 5382 of file basic_string.h.
References std::basic_string< _CharT, _Traits, _Alloc >::rfind().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), std::basic_string< _CharT, _Traits, _Alloc >::rfind(), std::basic_string< _CharT, _Traits, _Alloc >::rfind(), and std::basic_string< _CharT, _Traits, _Alloc >::rfind().
|
inlinenoexcept |
Definition at line 316 of file debug/string.
|
inlinenoexcept |
Returns the number of characters in the string, not including any null-termination.
Definition at line 3963 of file basic_string.h.
|
inline |
Definition at line 1021 of file debug/string.
|
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 958 of file basic_string.tcc.
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::assign(), and std::basic_string< _CharT, _Traits, _Alloc >::operator=().
|
inlinenoexcept |
Definition at line 853 of file debug/string.
|
friend |
Definition at line 106 of file debug/string.
|
static |
Value returned by various member functions when they fail.
Definition at line 3388 of file basic_string.h.