.TH "__gnu_debug::basic_string< _CharT, _Traits, _Allocator >" 3cxx "libstdc++" \" -*- nroff -*- .ad l .nh .SH NAME __gnu_debug::basic_string< _CharT, _Traits, _Allocator > \- Class std::basic_string with safety/checking/debug instrumentation\&. .SH SYNOPSIS .br .PP .PP \fC#include \fP .PP Inherits \fB__gnu_debug::_Safe_container< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware >\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >\fP\&. .SS "Public Types" .in +1c .ti -1c .RI "typedef _Allocator \fBallocator_type\fP" .br .ti -1c .RI "typedef \fB__gnu_debug::_Safe_iterator\fP< typename _Base::const_iterator, \fBbasic_string\fP > \fBconst_iterator\fP" .br .ti -1c .RI "typedef _Base::const_pointer \fBconst_pointer\fP" .br .ti -1c .RI "typedef _Base::const_reference \fBconst_reference\fP" .br .ti -1c .RI "typedef \fBstd::reverse_iterator\fP< \fBconst_iterator\fP > \fBconst_reverse_iterator\fP" .br .ti -1c .RI "typedef _Base::difference_type \fBdifference_type\fP" .br .ti -1c .RI "typedef \fB__gnu_debug::_Safe_iterator\fP< typename _Base::iterator, \fBbasic_string\fP > \fBiterator\fP" .br .ti -1c .RI "typedef _Base::pointer \fBpointer\fP" .br .ti -1c .RI "typedef _Base::reference \fBreference\fP" .br .ti -1c .RI "typedef \fBstd::reverse_iterator\fP< \fBiterator\fP > \fBreverse_iterator\fP" .br .ti -1c .RI "typedef _Base::size_type \fBsize_type\fP" .br .ti -1c .RI "typedef _Traits \fBtraits_type\fP" .br .ti -1c .RI "typedef _Traits::char_type \fBvalue_type\fP" .br .in -1c .SS "Public Member Functions" .in +1c .ti -1c .RI "\fBbasic_string\fP (\fB_Base\fP &&\fB__base\fP) noexcept" .br .ti -1c .RI "template \fBbasic_string\fP (_InputIterator __begin, _InputIterator __end, const _Allocator &__a=_Allocator())" .br .ti -1c .RI "\fBbasic_string\fP (\fBbasic_string\fP &&)=default" .br .ti -1c .RI "\fBbasic_string\fP (const _Allocator &__a) noexcept" .br .ti -1c .RI "\fBbasic_string\fP (const \fB_Base\fP &\fB__base\fP)" .br .ti -1c .RI "\fBbasic_string\fP (const _CharT *__s, const _Allocator &__a=_Allocator())" .br .ti -1c .RI "\fBbasic_string\fP (const _CharT *__s, size_type __n, const _Allocator &__a=_Allocator())" .br .ti -1c .RI "\fBbasic_string\fP (const \fBbasic_string\fP &)=default" .br .ti -1c .RI "\fBbasic_string\fP (const \fBbasic_string\fP &__str, size_type __pos, size_type __n=\fB_Base::npos\fP, const _Allocator &__a=_Allocator())" .br .ti -1c .RI "\fBbasic_string\fP (size_type __n, _CharT __c, const _Allocator &__a=_Allocator())" .br .ti -1c .RI "\fBbasic_string\fP (\fBstd::initializer_list\fP< _CharT > __l, const _Allocator &__a=_Allocator())" .br .ti -1c .RI "const \fB_Base\fP & \fB_M_base\fP () const noexcept" .br .ti -1c .RI "\fB_Base\fP & \fB_M_base\fP () noexcept" .br .ti -1c .RI "template \fBbasic_string\fP< _CharT, _Traits, _Alloc > & \fB_M_replace_dispatch\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, _InputIterator __k1, _InputIterator __k2, __false_type)" .br .ti -1c .RI "void \fB_M_swap\fP (\fB_Safe_container\fP &__x) noexcept" .br .ti -1c .RI "template _CharT * \fB_S_construct\fP (_InIterator __beg, _InIterator __end, const _Alloc &__a, forward_iterator_tag)" .br .ti -1c .RI "template \fBbasic_string\fP & \fBappend\fP (_InputIterator __first, _InputIterator __last)" .br .ti -1c .RI "\fBbasic_string\fP & \fBappend\fP (const _CharT *__s)" .br .ti -1c .RI "\fBbasic_string\fP & \fBappend\fP (const _CharT *__s, size_type __n)" .br .ti -1c .RI "\fBbasic_string\fP & \fBappend\fP (const \fBbasic_string\fP &__str)" .br .RI "Append a string to this string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBappend\fP (const \fBbasic_string\fP &__str)" .br .ti -1c .RI "\fBbasic_string\fP & \fBappend\fP (const \fBbasic_string\fP &__str, size_type __pos, size_type __n)" .br .ti -1c .RI "\fBbasic_string\fP & \fBappend\fP (const \fBbasic_string\fP &__str, size_type __pos, size_type __n=\fBnpos\fP)" .br .RI "Append a substring\&. " .ti -1c .RI "\fBbasic_string\fP & \fBappend\fP (initializer_list< _CharT > __l)" .br .RI "Append an initializer_list of characters\&. " .ti -1c .RI "\fBbasic_string\fP & \fBappend\fP (size_type __n, _CharT __c)" .br .ti -1c .RI "template \fBbasic_string\fP & \fBassign\fP (_InputIterator __first, _InputIterator __last)" .br .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (\fBbasic_string\fP &&__str) noexcept(allocator_traits< _Alloc >::is_always_equal::value)" .br .RI "Set value to contents of another string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (\fBbasic_string\fP &&__x) noexcept(noexcept(std::declval< \fB_Base\fP & >()\&.assign(std::move(__x))))" .br .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (const _CharT *__s)" .br .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (const _CharT *__s, size_type __n)" .br .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (const \fBbasic_string\fP &__str)" .br .RI "Set value to contents of another string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (const \fBbasic_string\fP &__str, size_type __pos, size_type __n)" .br .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (const \fBbasic_string\fP &__str, size_type __pos, size_type __n=\fBnpos\fP)" .br .RI "Set value to a substring of a string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (const \fBbasic_string\fP &__x)" .br .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (size_type __n, _CharT __c)" .br .ti -1c .RI "\fBbasic_string\fP & \fBassign\fP (\fBstd::initializer_list\fP< _CharT > __l)" .br .ti -1c .RI "reference \fBat\fP (size_type __n)" .br .RI "Provides access to the data contained in the string\&. " .ti -1c .RI "const_reference \fBat\fP (size_type __n) const" .br .RI "Provides access to the data contained in the string\&. " .ti -1c .RI "reference \fBback\fP ()" .br .ti -1c .RI "const_reference \fBback\fP () const noexcept" .br .ti -1c .RI "\fBiterator\fP \fBbegin\fP ()" .br .ti -1c .RI "\fBconst_iterator\fP \fBbegin\fP () const noexcept" .br .ti -1c .RI "const _CharT * \fBc_str\fP () const noexcept" .br .ti -1c .RI "size_type \fBcapacity\fP () const noexcept" .br .ti -1c .RI "\fBconst_iterator\fP \fBcbegin\fP () const noexcept" .br .ti -1c .RI "\fBconst_iterator\fP \fBcend\fP () const noexcept" .br .ti -1c .RI "void \fBclear\fP ()" .br .ti -1c .RI "int \fBcompare\fP (const _CharT *__s) const" .br .ti -1c .RI "int \fBcompare\fP (const \fBbasic_string\fP &__str) const" .br .RI "Compare to a string\&. " .ti -1c .RI "int \fBcompare\fP (const \fBbasic_string\fP &__str) const" .br .ti -1c .RI "int \fBcompare\fP (size_type __pos, size_type __n, const \fBbasic_string\fP &__str) const" .br .RI "Compare substring to a string\&. " .ti -1c .RI "int \fBcompare\fP (size_type __pos1, size_type __n1, const _CharT *__s) const" .br .ti -1c .RI "int \fBcompare\fP (size_type __pos1, size_type __n1, const _CharT *__s, size_type __n2) const" .br .ti -1c .RI "int \fBcompare\fP (size_type __pos1, size_type __n1, const \fBbasic_string\fP &__str) const" .br .ti -1c .RI "int \fBcompare\fP (size_type __pos1, size_type __n1, const \fBbasic_string\fP &__str, size_type __pos2, size_type __n2) const" .br .ti -1c .RI "int \fBcompare\fP (size_type __pos1, size_type __n1, const \fBbasic_string\fP &__str, size_type __pos2, size_type __n2=\fBnpos\fP) const" .br .RI "Compare substring to a substring\&. " .ti -1c .RI "size_type \fBcopy\fP (_CharT *__s, size_type __n, size_type __pos=0) const" .br .ti -1c .RI "\fBconst_reverse_iterator\fP \fBcrbegin\fP () const noexcept" .br .ti -1c .RI "\fBconst_reverse_iterator\fP \fBcrend\fP () const noexcept" .br .ti -1c .RI "const _CharT * \fBdata\fP () const noexcept" .br .ti -1c .RI "_GLIBCXX_NODISCARD bool \fBempty\fP () const noexcept" .br .ti -1c .RI "\fBiterator\fP \fBend\fP ()" .br .ti -1c .RI "\fBconst_iterator\fP \fBend\fP () const noexcept" .br .ti -1c .RI "\fBiterator\fP \fBerase\fP (\fBiterator\fP __first, \fBiterator\fP __last)" .br .RI "Remove a range of characters\&. " .ti -1c .RI "\fBiterator\fP \fBerase\fP (\fBiterator\fP __first, \fBiterator\fP __last)" .br .ti -1c .RI "\fBiterator\fP \fBerase\fP (\fBiterator\fP __position)" .br .RI "Remove one character\&. " .ti -1c .RI "\fBiterator\fP \fBerase\fP (\fBiterator\fP __position)" .br .ti -1c .RI "\fBbasic_string\fP & \fBerase\fP (size_type __pos=0, size_type __n=\fB_Base::npos\fP)" .br .ti -1c .RI "size_type \fBfind\fP (_CharT __c, size_type __pos=0) const noexcept" .br .ti -1c .RI "size_type \fBfind\fP (const _CharT *__s, size_type __pos, size_type __n) const" .br .ti -1c .RI "size_type \fBfind\fP (const _CharT *__s, size_type __pos=0) const" .br .ti -1c .RI "size_type \fBfind\fP (const \fBbasic_string\fP &__str, size_type __pos=0) const noexcept" .br .RI "Find position of a string\&. " .ti -1c .RI "size_type \fBfind\fP (const \fBbasic_string\fP &__str, size_type __pos=0) const noexcept" .br .ti -1c .RI "size_type \fBfind_first_not_of\fP (_CharT __c, size_type __pos=0) const noexcept" .br .ti -1c .RI "size_type \fBfind_first_not_of\fP (const _CharT *__s, size_type __pos, size_type __n) const" .br .ti -1c .RI "size_type \fBfind_first_not_of\fP (const _CharT *__s, size_type __pos=0) const" .br .ti -1c .RI "size_type \fBfind_first_not_of\fP (const \fBbasic_string\fP &__str, size_type __pos=0) const noexcept" .br .RI "Find position of a character not in string\&. " .ti -1c .RI "size_type \fBfind_first_not_of\fP (const \fBbasic_string\fP &__str, size_type __pos=0) const noexcept" .br .ti -1c .RI "size_type \fBfind_first_of\fP (_CharT __c, size_type __pos=0) const noexcept" .br .ti -1c .RI "size_type \fBfind_first_of\fP (const _CharT *__s, size_type __pos, size_type __n) const" .br .ti -1c .RI "size_type \fBfind_first_of\fP (const _CharT *__s, size_type __pos=0) const" .br .ti -1c .RI "size_type \fBfind_first_of\fP (const \fBbasic_string\fP &__str, size_type __pos=0) const noexcept" .br .RI "Find position of a character of string\&. " .ti -1c .RI "size_type \fBfind_first_of\fP (const \fBbasic_string\fP &__str, size_type __pos=0) const noexcept" .br .ti -1c .RI "size_type \fBfind_last_not_of\fP (_CharT __c, size_type __pos=\fB_Base::npos\fP) const noexcept" .br .ti -1c .RI "size_type \fBfind_last_not_of\fP (const _CharT *__s, size_type __pos, size_type __n) const" .br .ti -1c .RI "size_type \fBfind_last_not_of\fP (const _CharT *__s, size_type __pos=\fB_Base::npos\fP) const" .br .ti -1c .RI "size_type \fBfind_last_not_of\fP (const \fBbasic_string\fP &__str, size_type __pos=\fB_Base::npos\fP) const noexcept" .br .ti -1c .RI "size_type \fBfind_last_not_of\fP (const \fBbasic_string\fP &__str, size_type __pos=\fBnpos\fP) const noexcept" .br .RI "Find last position of a character not in string\&. " .ti -1c .RI "size_type \fBfind_last_of\fP (_CharT __c, size_type __pos=\fB_Base::npos\fP) const noexcept" .br .ti -1c .RI "size_type \fBfind_last_of\fP (const _CharT *__s, size_type __pos, size_type __n) const" .br .ti -1c .RI "size_type \fBfind_last_of\fP (const _CharT *__s, size_type __pos=\fB_Base::npos\fP) const" .br .ti -1c .RI "size_type \fBfind_last_of\fP (const \fBbasic_string\fP &__str, size_type __pos=\fB_Base::npos\fP) const noexcept" .br .ti -1c .RI "size_type \fBfind_last_of\fP (const \fBbasic_string\fP &__str, size_type __pos=\fBnpos\fP) const noexcept" .br .RI "Find last position of a character of string\&. " .ti -1c .RI "reference \fBfront\fP ()" .br .ti -1c .RI "const_reference \fBfront\fP () const noexcept" .br .ti -1c .RI "allocator_type \fBget_allocator\fP () const noexcept" .br .RI "Return copy of allocator used to construct this string\&. " .ti -1c .RI "\fBiterator\fP \fBinsert\fP (\fB__const_iterator\fP __p, _CharT __c)" .br .ti -1c .RI "template \fBiterator\fP \fBinsert\fP (\fB__const_iterator\fP __p, _InputIterator __first, _InputIterator __last)" .br .ti -1c .RI "\fBiterator\fP \fBinsert\fP (\fBconst_iterator\fP __p, size_type __n, _CharT __c)" .br .ti -1c .RI "\fBiterator\fP \fBinsert\fP (\fBconst_iterator\fP __p, \fBstd::initializer_list\fP< _CharT > __l)" .br .ti -1c .RI "\fBiterator\fP \fBinsert\fP (\fBiterator\fP __p, _CharT __c)" .br .RI "Insert one character\&. " .ti -1c .RI "template void \fBinsert\fP (\fBiterator\fP __p, _InputIterator __beg, _InputIterator __end)" .br .RI "Insert a range of characters\&. " .ti -1c .RI "void \fBinsert\fP (\fBiterator\fP __p, initializer_list< _CharT > __l)" .br .RI "Insert an initializer_list of characters\&. " .ti -1c .RI "void \fBinsert\fP (\fBiterator\fP __p, size_type __n, _CharT __c)" .br .RI "Insert multiple characters\&. " .ti -1c .RI "\fBbasic_string\fP & \fBinsert\fP (size_type __pos, const _CharT *__s)" .br .ti -1c .RI "\fBbasic_string\fP & \fBinsert\fP (size_type __pos, const _CharT *__s, size_type __n)" .br .ti -1c .RI "\fBbasic_string\fP & \fBinsert\fP (size_type __pos, size_type __n, _CharT __c)" .br .ti -1c .RI "\fBbasic_string\fP & \fBinsert\fP (size_type __pos1, const \fBbasic_string\fP &__str)" .br .RI "Insert value of a string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBinsert\fP (size_type __pos1, const \fBbasic_string\fP &__str)" .br .ti -1c .RI "\fBbasic_string\fP & \fBinsert\fP (size_type __pos1, const \fBbasic_string\fP &__str, size_type __pos2, size_type __n)" .br .ti -1c .RI "\fBbasic_string\fP & \fBinsert\fP (size_type __pos1, const \fBbasic_string\fP &__str, size_type __pos2, size_type __n=\fBnpos\fP)" .br .RI "Insert a substring\&. " .ti -1c .RI "size_type \fBlength\fP () const noexcept" .br .RI "Returns the number of characters in the string, not including any null-termination\&. " .ti -1c .RI "size_type \fBmax_size\fP () const noexcept" .br .RI "Returns the size() of the largest possible string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBoperator+=\fP (_CharT __c)" .br .ti -1c .RI "\fBbasic_string\fP & \fBoperator+=\fP (const _CharT *__s)" .br .ti -1c .RI "\fBbasic_string\fP & \fBoperator+=\fP (const \fBbasic_string\fP &__str)" .br .RI "Append a string to this string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBoperator+=\fP (const \fBbasic_string\fP &__str)" .br .ti -1c .RI "\fBbasic_string\fP & \fBoperator+=\fP (\fBstd::initializer_list\fP< _CharT > __l)" .br .ti -1c .RI "\fBbasic_string\fP & \fBoperator=\fP (_CharT __c)" .br .ti -1c .RI "\fBbasic_string\fP & \fBoperator=\fP (\fBbasic_string\fP &&)=default" .br .ti -1c .RI "\fBbasic_string\fP & \fBoperator=\fP (const _CharT *__s)" .br .ti -1c .RI "\fBbasic_string\fP & \fBoperator=\fP (const \fBbasic_string\fP &)=default" .br .ti -1c .RI "\fBbasic_string\fP & \fBoperator=\fP (\fBstd::initializer_list\fP< _CharT > __l)" .br .ti -1c .RI "reference \fBoperator[]\fP (size_type __pos)" .br .ti -1c .RI "const_reference \fBoperator[]\fP (size_type __pos) const noexcept" .br .ti -1c .RI "void \fBpop_back\fP ()" .br .ti -1c .RI "void \fBpush_back\fP (_CharT __c)" .br .ti -1c .RI "\fBreverse_iterator\fP \fBrbegin\fP ()" .br .ti -1c .RI "\fBconst_reverse_iterator\fP \fBrbegin\fP () const noexcept" .br .ti -1c .RI "\fBreverse_iterator\fP \fBrend\fP ()" .br .ti -1c .RI "\fBconst_reverse_iterator\fP \fBrend\fP () const noexcept" .br .ti -1c .RI "template \fBbasic_string\fP & \fBreplace\fP (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, _InputIterator __j1, _InputIterator __j2)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, const _CharT *__s)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, const _CharT *__s, size_type __n)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, const \fBbasic_string\fP &__str)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, size_type __n, _CharT __c)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, \fBstd::initializer_list\fP< _CharT > __l)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, _CharT *__k1, _CharT *__k2)" .br .ti -1c .RI "template \fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, _InputIterator __k1, _InputIterator __k2)" .br .RI "Replace range of characters with range\&. " .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, const _CharT *__k1, const _CharT *__k2)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, const _CharT *__s)" .br .RI "Replace range of characters with C string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, const _CharT *__s, size_type __n)" .br .RI "Replace range of characters with C substring\&. " .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, const \fBbasic_string\fP &__str)" .br .RI "Replace range of characters with string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, \fBconst_iterator\fP __k1, \fBconst_iterator\fP __k2)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, initializer_list< _CharT > __l)" .br .RI "Replace range of characters with initializer_list\&. " .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, \fBiterator\fP __k1, \fBiterator\fP __k2)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (\fBiterator\fP __i1, \fBiterator\fP __i2, size_type __n, _CharT __c)" .br .RI "Replace range of characters with multiple characters\&. " .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (size_type __pos, size_type __n, const \fBbasic_string\fP &__str)" .br .RI "Replace characters with value from another string\&. " .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (size_type __pos, size_type __n1, const _CharT *__s)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (size_type __pos, size_type __n1, const _CharT *__s, size_type __n2)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (size_type __pos, size_type __n1, size_type __n2, _CharT __c)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (size_type __pos1, size_type __n1, const \fBbasic_string\fP &__str)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (size_type __pos1, size_type __n1, const \fBbasic_string\fP &__str, size_type __pos2, size_type __n2)" .br .ti -1c .RI "\fBbasic_string\fP & \fBreplace\fP (size_type __pos1, size_type __n1, const \fBbasic_string\fP &__str, size_type __pos2, size_type __n2=\fBnpos\fP)" .br .RI "Replace characters with value from another string\&. " .ti -1c .RI "void \fBreserve\fP (size_type __res_arg=0)" .br .RI "Attempt to preallocate enough memory for specified number of characters\&. " .ti -1c .RI "void \fBresize\fP (size_type __n)" .br .ti -1c .RI "void \fBresize\fP (size_type __n, _CharT __c)" .br .ti -1c .RI "size_type \fBrfind\fP (_CharT __c, size_type __pos=\fB_Base::npos\fP) const noexcept" .br .ti -1c .RI "size_type \fBrfind\fP (const _CharT *__s, size_type __pos, size_type __n) const" .br .ti -1c .RI "size_type \fBrfind\fP (const _CharT *__s, size_type __pos=\fB_Base::npos\fP) const" .br .ti -1c .RI "size_type \fBrfind\fP (const \fBbasic_string\fP &__str, size_type __pos=\fB_Base::npos\fP) const noexcept" .br .ti -1c .RI "size_type \fBrfind\fP (const \fBbasic_string\fP &__str, size_type __pos=\fBnpos\fP) const noexcept" .br .RI "Find last position of a string\&. " .ti -1c .RI "void \fBshrink_to_fit\fP () noexcept" .br .ti -1c .RI "size_type \fBsize\fP () const noexcept" .br .RI "Returns the number of characters in the string, not including any null-termination\&. " .ti -1c .RI "\fBbasic_string\fP \fBsubstr\fP (size_type __pos=0, size_type __n=\fB_Base::npos\fP) const" .br .ti -1c .RI "void \fBswap\fP (\fBbasic_string\fP &__s) noexcept(/*conditional */)" .br .RI "Swap contents with another string\&. " .ti -1c .RI "void \fBswap\fP (\fBbasic_string\fP &__x) noexcept(/*conditional */)" .br .in -1c .SS "Static Public Attributes" .in +1c .ti -1c .RI "static const size_type \fBnpos\fP" .br .RI "Value returned by various member functions when they fail\&. " .in -1c .SS "Protected Member Functions" .in +1c .ti -1c .RI "\fB_Safe_container\fP & \fB_M_safe\fP () noexcept" .br .in -1c .SS "Friends" .in +1c .ti -1c .RI "template class \fB::__gnu_debug::_Safe_iterator\fP" .br .in -1c .SH "Detailed Description" .PP .SS "template, typename _Allocator = std::allocator<_CharT>> .br class __gnu_debug::basic_string< _CharT, _Traits, _Allocator >"Class std::basic_string with safety/checking/debug instrumentation\&. .PP Definition at line \fB86\fP of file \fBdebug/string\fP\&. .SH "Member Typedef Documentation" .PP .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Allocator \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::allocator_type" .PP Definition at line \fB108\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef \fB__gnu_debug::_Safe_iterator\fP< typename _Base::const_iterator, \fBbasic_string\fP> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::const_iterator" .PP Definition at line \fB119\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Base::const_pointer \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::const_pointer" .PP Definition at line \fB114\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Base::const_reference \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::const_reference" .PP Definition at line \fB112\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef \fBstd::reverse_iterator\fP<\fBconst_iterator\fP> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::const_reverse_iterator" .PP Definition at line \fB122\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Base::difference_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::difference_type" .PP Definition at line \fB110\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef \fB__gnu_debug::_Safe_iterator\fP< typename _Base::iterator, \fBbasic_string\fP> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::iterator" .PP Definition at line \fB117\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Base::pointer \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::pointer" .PP Definition at line \fB113\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Base::reference \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::reference" .PP Definition at line \fB111\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef \fBstd::reverse_iterator\fP<\fBiterator\fP> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::reverse_iterator" .PP Definition at line \fB121\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Base::size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::size_type" .PP Definition at line \fB109\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Traits \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::traits_type" .PP Definition at line \fB106\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> typedef _Traits::char_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::value_type" .PP Definition at line \fB107\fP of file \fBdebug/string\fP\&. .SH "Constructor & Destructor Documentation" .PP .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string ()\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB126\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (const _Allocator & __a)\fC [inline]\fP, \fC [explicit]\fP, \fC [noexcept]\fP" .PP Definition at line \fB132\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (\fBstd::initializer_list\fP< _CharT > __l, const _Allocator & __a = \fC_Allocator()\fP)\fC [inline]\fP" .PP Definition at line \fB144\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (\fB_Base\fP && __base)\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB160\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (const \fB_Base\fP & __base)\fC [inline]\fP" .PP Definition at line \fB165\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos, size_type __n = \fC\fB_Base::npos\fP\fP, const _Allocator & __a = \fC_Allocator()\fP)\fC [inline]\fP" .PP Definition at line \fB170\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (const _CharT * __s, size_type __n, const _Allocator & __a = \fC_Allocator()\fP)\fC [inline]\fP" .PP Definition at line \fB175\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (const _CharT * __s, const _Allocator & __a = \fC_Allocator()\fP)\fC [inline]\fP" .PP Definition at line \fB179\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (size_type __n, _CharT __c, const _Allocator & __a = \fC_Allocator()\fP)\fC [inline]\fP" .PP Definition at line \fB183\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> template \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::basic_string (_InputIterator __begin, _InputIterator __end, const _Allocator & __a = \fC_Allocator()\fP)\fC [inline]\fP" .PP Definition at line \fB188\fP of file \fBdebug/string\fP\&. .SH "Member Function Documentation" .PP .SS "template, typename _Allocator = std::allocator<_CharT>> const \fB_Base\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::_M_base () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB1051\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fB_Base\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::_M_base ()\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB1048\fP of file \fBdebug/string\fP\&. .SS "template template \fBbasic_string\fP< _CharT, _Traits, _Alloc > & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::_M_replace_dispatch (iterator __i1, iterator __i2, \fB_InputIterator\fP __k1, \fB_InputIterator\fP __k2, __false_type)\fC [inherited]\fP" .PP Definition at line \fB1105\fP of file \fBbasic_string\&.tcc\fP\&. .SS "template class _SafeBase, bool _IsCxx11AllocatorAware = true> \fB_Safe_container\fP & \fB__gnu_debug::_Safe_container\fP< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware >::_M_safe ()\fC [inline]\fP, \fC [protected]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Definition at line \fB52\fP of file \fBsafe_container\&.h\fP\&. .SS "template class _SafeBase, bool _IsCxx11AllocatorAware = true> void \fB__gnu_debug::_Safe_container\fP< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware >::_M_swap (\fB_Safe_container\fP< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware > & __x)\fC [inline]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Definition at line \fB104\fP of file \fBsafe_container\&.h\fP\&. .SS "template template _CharT * \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::_S_construct (\fB_InIterator\fP __beg, \fB_InIterator\fP __end, \fBconst\fP _Alloc & __a, \fBforward_iterator_tag\fP)\fC [inherited]\fP" .PP Definition at line \fB563\fP of file \fBbasic_string\&.tcc\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> template \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::append (_InputIterator __first, _InputIterator __last)\fC [inline]\fP" .PP Definition at line \fB448\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::append (const _CharT * __s)\fC [inline]\fP" .PP Definition at line \fB430\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::append (const _CharT * __s, size_type __n)\fC [inline]\fP" .PP Definition at line \fB421\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP< _CharT, _Traits, _Alloc > & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::append (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str)\fC [inherited]\fP" .PP Append a string to this string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP The string to append\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP .PP Definition at line \fB774\fP of file \fBbasic_string\&.tcc\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::append()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::append()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::operator+=()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::operator+=()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::operator+=()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::append (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str)\fC [inline]\fP" .PP Definition at line \fB405\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::append (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos, size_type __n)\fC [inline]\fP" .PP Definition at line \fB413\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP< _CharT, _Traits, _Alloc > & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::append (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos, size_type __n = \fC\fBnpos\fP\fP)\fC [inherited]\fP" .PP Append a substring\&. .PP \fBParameters\fP .RS 4 \fI__str\fP The string to append\&. .br \fI__pos\fP Index of the first character of str to append\&. .br \fI__n\fP The number of characters to append\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::out_of_range\fP if \fI__pos\fP is not a valid index\&. .RE .PP This function appends \fI__n\fP characters from \fI__str\fP starting at \fI__pos\fP to this string\&. If \fI__n\fP is is larger than the number of available characters in \fI__str\fP, the remainder of \fI__str\fP is appended\&. .PP Definition at line \fB791\fP of file \fBbasic_string\&.tcc\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::append (\fBinitializer_list\fP< _CharT > __l)\fC [inline]\fP, \fC [inherited]\fP" .PP Append an initializer_list of characters\&. .PP \fBParameters\fP .RS 4 \fI__l\fP The initializer_list of characters to append\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP .PP Definition at line \fB4273\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::append()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::append (size_type __n, _CharT __c)\fC [inline]\fP" .PP Definition at line \fB439\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> template \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::assign (_InputIterator __first, _InputIterator __last)\fC [inline]\fP" .PP Definition at line \fB527\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::assign (\fBbasic_string\fP< _CharT, _Traits, _Alloc > && __str)\fC [inline]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Set value to contents of another string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP Source string to use\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP This function sets this string to the exact contents of \fI__str\fP\&. \fI__str\fP is a valid, but unspecified string\&. .PP Definition at line \fB4355\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::swap()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::assign (\fBbasic_string\fP< _CharT, _Traits, _Allocator > && __x)\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB482\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::assign (const _CharT * __s)\fC [inline]\fP" .PP Definition at line \fB509\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::assign (const _CharT * __s, size_type __n)\fC [inline]\fP" .PP Definition at line \fB500\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP< _CharT, _Traits, _Alloc > & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::assign (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str)\fC [inherited]\fP" .PP Set value to contents of another string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP Source string to use\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP .PP Definition at line \fB692\fP of file \fBbasic_string\&.tcc\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::assign()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::assign()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::assign()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::operator=()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::operator=()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::operator=()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::operator=()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::assign (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos, size_type __n)\fC [inline]\fP" .PP Definition at line \fB492\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::assign (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos, size_type __n = \fC\fBnpos\fP\fP)\fC [inline]\fP, \fC [inherited]\fP" .PP Set value to a substring of a string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP The string to use\&. .br \fI__pos\fP Index of the first character of str\&. .br \fI__n\fP Number of characters to use\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::out_of_range\fP if \fIpos\fP is not a valid index\&. .RE .PP This function sets this string to the substring of \fI__str\fP consisting of \fI__n\fP characters at \fI__pos\fP\&. If \fI__n\fP is is larger than the number of available characters in \fI__str\fP, the remainder of \fI__str\fP is used\&. .PP Definition at line \fB4377\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::assign()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::assign (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __x)\fC [inline]\fP" .PP Definition at line \fB473\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::assign (size_type __n, _CharT __c)\fC [inline]\fP" .PP Definition at line \fB518\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::assign (\fBstd::initializer_list\fP< _CharT > __l)\fC [inline]\fP" .PP Definition at line \fB544\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> reference \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::at (size_type __n)\fC [inline]\fP" .PP Provides access to the data contained in the string\&. .PP \fBParameters\fP .RS 4 \fI__n\fP The index of the character to access\&. .RE .PP \fBReturns\fP .RS 4 Read/write reference to the character\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::out_of_range\fP If \fIn\fP is an invalid index\&. .RE .PP 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\&. .PP Definition at line \fB4099\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> const_reference \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::at (size_type __n) const\fC [inline]\fP" .PP Provides access to the data contained in the string\&. .PP \fBParameters\fP .RS 4 \fI__n\fP The index of the character to access\&. .RE .PP \fBReturns\fP .RS 4 Read-only (const) reference to the character\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::out_of_range\fP If \fIn\fP is an invalid index\&. .RE .PP 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\&. .PP Definition at line \fB4077\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> reference \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::back ()\fC [inline]\fP" Returns a read/write reference to the data at the last element of the string\&. .PP Definition at line \fB4138\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> const_reference \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::back () const\fC [inline]\fP, \fC [noexcept]\fP" Returns a read-only (constant) reference to the data at the last element of the string\&. .PP Definition at line \fB4149\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBiterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::begin ()\fC [inline]\fP" .PP Definition at line \fB239\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBconst_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::begin () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB243\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> const _CharT * \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::c_str () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB845\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::capacity () const\fC [inline]\fP, \fC [noexcept]\fP" Returns the total number of characters that the string can hold before needing to allocate more memory\&. .PP Definition at line \fB3973\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBconst_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::cbegin () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB272\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBconst_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::cend () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB276\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> void \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::clear ()\fC [inline]\fP" .PP Definition at line \fB325\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> int \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::compare (const _CharT * __s) const\fC [inline]\fP" .PP Definition at line \fB1022\fP of file \fBdebug/string\fP\&. .SS "template int \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::compare (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str) const\fC [inline]\fP, \fC [inherited]\fP" .PP Compare to a string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP String to compare against\&. .RE .PP \fBReturns\fP .RS 4 Integer < 0, 0, or > 0\&. .RE .PP Returns an integer < 0 if this string is ordered before \fI__str\fP, 0 if their values are equivalent, or > 0 if this string is ordered after \fI__str\fP\&. 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\&. .PP Definition at line \fB5759\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::min()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::size()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> int \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::compare (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str) const\fC [inline]\fP" .PP Definition at line \fB1008\fP of file \fBdebug/string\fP\&. .SS "template int \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::compare (size_type __pos, size_type __n, \fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str) const\fC [inherited]\fP" .PP Compare substring to a string\&. .PP \fBParameters\fP .RS 4 \fI__pos\fP Index of first character of substring\&. .br \fI__n\fP Number of characters in substring\&. .br \fI__str\fP String to compare against\&. .RE .PP \fBReturns\fP .RS 4 Integer < 0, 0, or > 0\&. .RE .PP Form the substring of this string from the \fI__n\fP characters starting at \fI__pos\fP\&. Returns an integer < 0 if the substring is ordered before \fI__str\fP, 0 if their values are equivalent, or > 0 if the substring is ordered after \fI__str\fP\&. Determines the effective length rlen of the strings to compare as the smallest of the length of the substring and \fI__str\&.size()\fP\&. 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\&. .PP Definition at line \fB1385\fP of file \fBbasic_string\&.tcc\fP\&. .PP References \fBstd::min()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> int \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::compare (size_type __pos1, size_type __n1, const _CharT * __s) const\fC [inline]\fP" .PP Definition at line \fB1031\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> int \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::compare (size_type __pos1, size_type __n1, const _CharT * __s, size_type __n2) const\fC [inline]\fP" .PP Definition at line \fB1040\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> int \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::compare (size_type __pos1, size_type __n1, const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str) const\fC [inline]\fP" .PP Definition at line \fB1012\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> int \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::compare (size_type __pos1, size_type __n1, const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos2, size_type __n2) const\fC [inline]\fP" .PP Definition at line \fB1017\fP of file \fBdebug/string\fP\&. .SS "template int \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::compare (size_type __pos1, size_type __n1, \fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos2, size_type __n2 = \fC\fBnpos\fP\fP) const\fC [inherited]\fP" .PP Compare substring to a substring\&. .PP \fBParameters\fP .RS 4 \fI__pos1\fP Index of first character of substring\&. .br \fI__n1\fP Number of characters in substring\&. .br \fI__str\fP String to compare against\&. .br \fI__pos2\fP Index of first character of substring of str\&. .br \fI__n2\fP Number of characters in substring of str\&. .RE .PP \fBReturns\fP .RS 4 Integer < 0, 0, or > 0\&. .RE .PP Form the substring of this string from the \fI__n1\fP characters starting at \fI__pos1\fP\&. Form the substring of \fI__str\fP from the \fI__n2\fP characters starting at \fI__pos2\fP\&. Returns an integer < 0 if this substring is ordered before the substring of \fI__str\fP, 0 if their values are equivalent, or > 0 if this substring is ordered after the substring of \fI__str\fP\&. 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\&. .PP Definition at line \fB1400\fP of file \fBbasic_string\&.tcc\fP\&. .PP References \fBstd::min()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::copy (_CharT * __s, size_type __n, size_type __pos = \fC0\fP) const\fC [inline]\fP" .PP Definition at line \fB829\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBconst_reverse_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::crbegin () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB280\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBconst_reverse_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::crend () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB284\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> const _CharT * \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::data () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB853\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> _GLIBCXX_NODISCARD bool \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::empty () const\fC [inline]\fP, \fC [noexcept]\fP" Returns true if the string is empty\&. Equivalent to \fC*this == ''\fP\&. .PP Definition at line \fB4023\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBiterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::end ()\fC [inline]\fP" .PP Definition at line \fB247\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBconst_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::end () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB251\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP< _CharT, _Traits, _Alloc >::iterator \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::erase (iterator __first, iterator __last)\fC [inherited]\fP" .PP Remove a range of characters\&. .PP \fBParameters\fP .RS 4 \fI__first\fP Iterator referencing the first character to remove\&. .br \fI__last\fP Iterator referencing the end of the range\&. .RE .PP \fBReturns\fP .RS 4 Iterator referencing location of first after removal\&. .RE .PP Removes the characters in the range [first,last) from this string\&. The value of the string doesn't change if an error is thrown\&. .PP Definition at line \fB840\fP of file \fBbasic_string\&.tcc\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBiterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::erase (\fBiterator\fP __first, \fBiterator\fP __last)\fC [inline]\fP" .PP Definition at line \fB688\fP of file \fBdebug/string\fP\&. .SS "template \fBiterator\fP \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::erase (iterator __position)\fC [inline]\fP, \fC [inherited]\fP" .PP Remove one character\&. .PP \fBParameters\fP .RS 4 \fI__position\fP Iterator referencing the character to remove\&. .RE .PP \fBReturns\fP .RS 4 iterator referencing same location after removal\&. .RE .PP Removes the character at \fI__position\fP from this string\&. The value of the string doesn't change if an error is thrown\&. .PP Definition at line \fB4722\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBiterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::erase (\fBiterator\fP __position)\fC [inline]\fP" .PP Definition at line \fB679\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::erase (size_type __pos = \fC0\fP, size_type __n = \fC\fB_Base::npos\fP\fP)\fC [inline]\fP" .PP Definition at line \fB671\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find (_CharT __c, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB882\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find (const _CharT * __s, size_type __pos, size_type __n) const\fC [inline]\fP" .PP Definition at line \fB868\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find (const _CharT * __s, size_type __pos = \fC0\fP) const\fC [inline]\fP" .PP Definition at line \fB875\fP of file \fBdebug/string\fP\&. .SS "template size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::find (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Find position of a string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP String to locate\&. .br \fI__pos\fP Index of character to search from (default 0)\&. .RE .PP \fBReturns\fP .RS 4 Index of start of first occurrence\&. .RE .PP Starting from \fI__pos\fP, searches forward for value of \fI__str\fP within this string\&. If found, returns the index where it begins\&. If not found, returns npos\&. .PP Definition at line \fB5267\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::find()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB863\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_first_not_of (_CharT __c, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB975\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_first_not_of (const _CharT * __s, size_type __pos, size_type __n) const\fC [inline]\fP" .PP Definition at line \fB961\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_first_not_of (const _CharT * __s, size_type __pos = \fC0\fP) const\fC [inline]\fP" .PP Definition at line \fB968\fP of file \fBdebug/string\fP\&. .SS "template size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::find_first_not_of (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Find position of a character not in string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP String containing characters to avoid\&. .br \fI__pos\fP Index of character to search from (default 0)\&. .RE .PP \fBReturns\fP .RS 4 Index of first occurrence\&. .RE .PP Starting from \fI__pos\fP, searches forward for a character not contained in \fI__str\fP within this string\&. If found, returns the index where it was found\&. If not found, returns npos\&. .PP Definition at line \fB5575\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of()\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_first_not_of (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB956\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_first_of (_CharT __c, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB928\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_first_of (const _CharT * __s, size_type __pos, size_type __n) const\fC [inline]\fP" .PP Definition at line \fB914\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_first_of (const _CharT * __s, size_type __pos = \fC0\fP) const\fC [inline]\fP" .PP Definition at line \fB921\fP of file \fBdebug/string\fP\&. .SS "template size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::find_first_of (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Find position of a character of string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP String containing characters to locate\&. .br \fI__pos\fP Index of character to search from (default 0)\&. .RE .PP \fBReturns\fP .RS 4 Index of first occurrence\&. .RE .PP Starting from \fI__pos\fP, searches forward for one of the characters of \fI__str\fP within this string\&. If found, returns the index where it was found\&. If not found, returns npos\&. .PP Definition at line \fB5408\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_first_of()\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_first_of()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_first_of()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_first_of (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos = \fC0\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB909\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_last_not_of (_CharT __c, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB999\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_last_not_of (const _CharT * __s, size_type __pos, size_type __n) const\fC [inline]\fP" .PP Definition at line \fB985\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_last_not_of (const _CharT * __s, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP" .PP Definition at line \fB992\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_last_not_of (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB979\fP of file \fBdebug/string\fP\&. .SS "template size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::find_last_not_of (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos = \fC\fBnpos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Find last position of a character not in string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP String containing characters to avoid\&. .br \fI__pos\fP Index of character to search back from (default end)\&. .RE .PP \fBReturns\fP .RS 4 Index of last occurrence\&. .RE .PP Starting from \fI__pos\fP, searches backward for a character not contained in \fI__str\fP within this string\&. If found, returns the index where it was found\&. If not found, returns npos\&. .PP Definition at line \fB5657\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of()\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_last_of (_CharT __c, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB951\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_last_of (const _CharT * __s, size_type __pos, size_type __n) const\fC [inline]\fP" .PP Definition at line \fB937\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_last_of (const _CharT * __s, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP" .PP Definition at line \fB944\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::find_last_of (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB932\fP of file \fBdebug/string\fP\&. .SS "template size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::find_last_of (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos = \fC\fBnpos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Find last position of a character of string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP String containing characters to locate\&. .br \fI__pos\fP Index of character to search back from (default end)\&. .RE .PP \fBReturns\fP .RS 4 Index of last occurrence\&. .RE .PP Starting from \fI__pos\fP, searches backward for one of the characters of \fI__str\fP within this string\&. If found, returns the index where it was found\&. If not found, returns npos\&. .PP Definition at line \fB5492\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_last_of()\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_last_of()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_last_of()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> reference \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::front ()\fC [inline]\fP" Returns a read/write reference to the data at the first element of the string\&. .PP Definition at line \fB4116\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> const_reference \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::front () const\fC [inline]\fP, \fC [noexcept]\fP" Returns a read-only (constant) reference to the data at the first element of the string\&. .PP Definition at line \fB4127\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> allocator_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::get_allocator () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Return copy of allocator used to construct this string\&. .PP Definition at line \fB5237\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBiterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (\fB__const_iterator\fP __p, _CharT __c)\fC [inline]\fP" .PP Definition at line \fB596\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> template \fBiterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (\fB__const_iterator\fP __p, _InputIterator __first, _InputIterator __last)\fC [inline]\fP" .PP Definition at line \fB631\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBiterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (\fBconst_iterator\fP __p, size_type __n, _CharT __c)\fC [inline]\fP" .PP Definition at line \fB606\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBiterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (\fBconst_iterator\fP __p, \fBstd::initializer_list\fP< _CharT > __l)\fC [inline]\fP" .PP Definition at line \fB655\fP of file \fBdebug/string\fP\&. .SS "template \fBiterator\fP \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::insert (iterator __p, _CharT __c)\fC [inline]\fP, \fC [inherited]\fP" .PP Insert one character\&. .PP \fBParameters\fP .RS 4 \fI__p\fP Iterator referencing position in string to insert at\&. .br \fI__c\fP The character to insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator referencing newly inserted char\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Inserts character \fI__c\fP at position referenced by \fI__p\fP\&. If adding character causes the length to exceed max_size(), length_error is thrown\&. If \fI__p\fP is beyond end of string, out_of_range is thrown\&. The value of the string doesn't change if an error is thrown\&. .PP Definition at line \fB4646\fP of file \fBbasic_string\&.h\fP\&. .SS "template template void \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::insert (iterator __p, \fB_InputIterator\fP __beg, \fB_InputIterator\fP __end)\fC [inline]\fP, \fC [inherited]\fP" .PP Insert a range of characters\&. .PP \fBParameters\fP .RS 4 \fI__p\fP Iterator referencing location in string to insert at\&. .br \fI__beg\fP Start of range\&. .br \fI__end\fP End of range\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP 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\&. .PP Definition at line \fB4511\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .SS "template void \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::insert (iterator __p, \fBinitializer_list\fP< _CharT > __l)\fC [inline]\fP, \fC [inherited]\fP" .PP Insert an initializer_list of characters\&. .PP \fBParameters\fP .RS 4 \fI__p\fP Iterator referencing location in string to insert at\&. .br \fI__l\fP The initializer_list of characters to insert\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP .PP Definition at line \fB4522\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP\&. .SS "template void \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::insert (iterator __p, size_type __n, _CharT __c)\fC [inline]\fP, \fC [inherited]\fP" .PP Insert multiple characters\&. .PP \fBParameters\fP .RS 4 \fI__p\fP Iterator referencing location in string to insert at\&. .br \fI__n\fP Number of characters to insert .br \fI__c\fP The character to insert\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Inserts \fI__n\fP copies of character \fI__c\fP starting at the position referenced by iterator \fI__p\fP\&. 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\&. .PP Definition at line \fB4494\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (size_type __pos, const _CharT * __s)\fC [inline]\fP" .PP Definition at line \fB579\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (size_type __pos, const _CharT * __s, size_type __n)\fC [inline]\fP" .PP Definition at line \fB570\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (size_type __pos, size_type __n, _CharT __c)\fC [inline]\fP" .PP Definition at line \fB588\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::insert (size_type __pos1, \fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str)\fC [inline]\fP, \fC [inherited]\fP" .PP Insert value of a string\&. .PP \fBParameters\fP .RS 4 \fI__pos1\fP Iterator referencing location in string to insert at\&. .br \fI__str\fP The string to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Inserts value of \fI__str\fP starting at \fI__pos1\fP\&. 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\&. .PP Definition at line \fB4542\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (size_type __pos1, const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str)\fC [inline]\fP" .PP Definition at line \fB553\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::insert (size_type __pos1, const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos2, size_type __n)\fC [inline]\fP" .PP Definition at line \fB561\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::insert (size_type __pos1, \fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos2, size_type __n = \fC\fBnpos\fP\fP)\fC [inline]\fP, \fC [inherited]\fP" .PP Insert a substring\&. .PP \fBParameters\fP .RS 4 \fI__pos1\fP Iterator referencing location in string to insert at\&. .br \fI__str\fP The string to insert\&. .br \fI__pos2\fP Start of characters in str to insert\&. .br \fI__n\fP Number of characters to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .br \fIstd::out_of_range\fP If \fIpos1\fP > size() or \fI__pos2\fP > \fIstr\&.size()\fP\&. .RE .PP Starting at \fIpos1\fP, insert \fI__n\fP character of \fI__str\fP beginning with \fI__pos2\fP\&. If adding characters causes the length to exceed max_size(), length_error is thrown\&. If \fI__pos1\fP is beyond the end of this string or \fI__pos2\fP is beyond the end of \fI__str\fP, out_of_range is thrown\&. The value of the string doesn't change if an error is thrown\&. .PP Definition at line \fB4564\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::length () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Returns the number of characters in the string, not including any null-termination\&. .PP Definition at line \fB3916\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::max_size () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Returns the size() of the largest possible string\&. .PP Definition at line \fB3921\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator+= (_CharT __c)\fC [inline]\fP" .PP Definition at line \fB387\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator+= (const _CharT * __s)\fC [inline]\fP" .PP Definition at line \fB378\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::operator+= (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str)\fC [inline]\fP, \fC [inherited]\fP" .PP Append a string to this string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP The string to append\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP .PP Definition at line \fB4163\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::append()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator+= (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str)\fC [inline]\fP" .PP Definition at line \fB370\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator+= (\fBstd::initializer_list\fP< _CharT > __l)\fC [inline]\fP" .PP Definition at line \fB396\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator= (_CharT __c)\fC [inline]\fP" .PP Definition at line \fB220\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator= (const _CharT * __s)\fC [inline]\fP" .PP Definition at line \fB211\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator= (\fBstd::initializer_list\fP< _CharT > __l)\fC [inline]\fP" .PP Definition at line \fB229\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> reference \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator[] (size_type __pos)\fC [inline]\fP" .PP Definition at line \fB346\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> const_reference \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::operator[] (size_type __pos) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB335\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> void \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::pop_back ()\fC [inline]\fP" .PP Definition at line \fB701\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> void \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::push_back (_CharT __c)\fC [inline]\fP" .PP Definition at line \fB466\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBreverse_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::rbegin ()\fC [inline]\fP" .PP Definition at line \fB255\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBconst_reverse_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::rbegin () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB259\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBreverse_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::rend ()\fC [inline]\fP" .PP Definition at line \fB263\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBconst_reverse_iterator\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::rend () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB267\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> template \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, _InputIterator __j1, _InputIterator __j2)\fC [inline]\fP" .PP Definition at line \fB797\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, const _CharT * __s)\fC [inline]\fP" .PP Definition at line \fB775\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, const _CharT * __s, size_type __n)\fC [inline]\fP" .PP Definition at line \fB764\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str)\fC [inline]\fP" .PP Definition at line \fB754\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, size_type __n, _CharT __c)\fC [inline]\fP" .PP Definition at line \fB786\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (\fB__const_iterator\fP __i1, \fB__const_iterator\fP __i2, \fBstd::initializer_list\fP< _CharT > __l)\fC [inline]\fP" .PP Definition at line \fB818\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, _CharT * __k1, _CharT * __k2)\fC [inline]\fP, \fC [inherited]\fP" .PP Definition at line \fB4983\fP of file \fBbasic_string\&.h\fP\&. .SS "template template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, \fB_InputIterator\fP __k1, \fB_InputIterator\fP __k2)\fC [inline]\fP, \fC [inherited]\fP" .PP Replace range of characters with range\&. .PP \fBParameters\fP .RS 4 \fI__i1\fP Iterator referencing start of range to replace\&. .br \fI__i2\fP Iterator referencing end of range to replace\&. .br \fI__k1\fP Iterator referencing start of range to insert\&. .br \fI__k2\fP Iterator referencing end of range to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP 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\&. .PP Definition at line \fB4970\fP of file \fBbasic_string\&.h\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, \fBconst\fP _CharT * __k1, \fBconst\fP _CharT * __k2)\fC [inline]\fP, \fC [inherited]\fP" .PP Definition at line \fB4993\fP of file \fBbasic_string\&.h\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, \fBconst\fP _CharT * __s)\fC [inline]\fP, \fC [inherited]\fP" .PP Replace range of characters with C string\&. .PP \fBParameters\fP .RS 4 \fI__i1\fP Iterator referencing start of range to replace\&. .br \fI__i2\fP Iterator referencing end of range to replace\&. .br \fI__s\fP C string value to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Removes the characters in the range [__i1,__i2)\&. In place, the characters of \fI__s\fP 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\&. .PP Definition at line \fB4925\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, \fBconst\fP _CharT * __s, size_type __n)\fC [inline]\fP, \fC [inherited]\fP" .PP Replace range of characters with C substring\&. .PP \fBParameters\fP .RS 4 \fI__i1\fP Iterator referencing start of range to replace\&. .br \fI__i2\fP Iterator referencing end of range to replace\&. .br \fI__s\fP C string value to insert\&. .br \fI__n\fP Number of characters from s to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Removes the characters in the range [__i1,__i2)\&. In place, the first \fI__n\fP characters of \fI__s\fP 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\&. .PP Definition at line \fB4904\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, \fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str)\fC [inline]\fP, \fC [inherited]\fP" .PP Replace range of characters with string\&. .PP \fBParameters\fP .RS 4 \fI__i1\fP Iterator referencing start of range to replace\&. .br \fI__i2\fP Iterator referencing end of range to replace\&. .br \fI__str\fP String value to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Removes the characters in the range [__i1,__i2)\&. In place, the value of \fI__str\fP 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\&. .PP Definition at line \fB4885\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, const_iterator __k1, const_iterator __k2)\fC [inline]\fP, \fC [inherited]\fP" .PP Definition at line \fB5014\fP of file \fBbasic_string\&.h\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, \fBinitializer_list\fP< _CharT > __l)\fC [inline]\fP, \fC [inherited]\fP" .PP Replace range of characters with initializer_list\&. .PP \fBParameters\fP .RS 4 \fI__i1\fP Iterator referencing start of range to replace\&. .br \fI__i2\fP Iterator referencing end of range to replace\&. .br \fI__l\fP The initializer_list of characters to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP 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\&. .PP Definition at line \fB5039\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, iterator __k1, iterator __k2)\fC [inline]\fP, \fC [inherited]\fP" .PP Definition at line \fB5004\fP of file \fBbasic_string\&.h\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, size_type __n, _CharT __c)\fC [inline]\fP, \fC [inherited]\fP" .PP Replace range of characters with multiple characters\&. .PP \fBParameters\fP .RS 4 \fI__i1\fP Iterator referencing start of range to replace\&. .br \fI__i2\fP Iterator referencing end of range to replace\&. .br \fI__n\fP Number of characters to insert\&. .br \fI__c\fP Character to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Removes the characters in the range [__i1,__i2)\&. In place, \fI__n\fP copies of \fI__c\fP 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\&. .PP Definition at line \fB4946\fP of file \fBbasic_string\&.h\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (size_type __pos, size_type __n, \fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str)\fC [inline]\fP, \fC [inherited]\fP" .PP Replace characters with value from another string\&. .PP \fBParameters\fP .RS 4 \fI__pos\fP Index of first character to replace\&. .br \fI__n\fP Number of characters to be replaced\&. .br \fI__str\fP String to insert\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::out_of_range\fP If \fIpos\fP is beyond the end of this string\&. .br \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Removes the characters in the range [__pos,__pos+__n) from this string\&. In place, the value of \fI__str\fP is inserted\&. If \fI__pos\fP 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\&. .PP Definition at line \fB4776\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::append()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::assign()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::insert()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (size_type __pos, size_type __n1, const _CharT * __s)\fC [inline]\fP" .PP Definition at line \fB737\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (size_type __pos, size_type __n1, const _CharT * __s, size_type __n2)\fC [inline]\fP" .PP Definition at line \fB727\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (size_type __pos, size_type __n1, size_type __n2, _CharT __c)\fC [inline]\fP" .PP Definition at line \fB746\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (size_type __pos1, size_type __n1, const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str)\fC [inline]\fP" .PP Definition at line \fB710\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP & \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::replace (size_type __pos1, size_type __n1, const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos2, size_type __n2)\fC [inline]\fP" .PP Definition at line \fB718\fP of file \fBdebug/string\fP\&. .SS "template \fBbasic_string\fP & \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::replace (size_type __pos1, size_type __n1, \fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos2, size_type __n2 = \fC\fBnpos\fP\fP)\fC [inline]\fP, \fC [inherited]\fP" .PP Replace characters with value from another string\&. .PP \fBParameters\fP .RS 4 \fI__pos1\fP Index of first character to replace\&. .br \fI__n1\fP Number of characters to be replaced\&. .br \fI__str\fP String to insert\&. .br \fI__pos2\fP Index of first character of str to use\&. .br \fI__n2\fP Number of characters from str to use\&. .RE .PP \fBReturns\fP .RS 4 Reference to this string\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::out_of_range\fP If \fI__pos1\fP > size() or \fI__pos2\fP > __str\&.size()\&. .br \fIstd::length_error\fP If new length exceeds \fCmax_size()\fP\&. .RE .PP Removes the characters in the range [__pos1,__pos1 + n) from this string\&. In place, the value of \fI__str\fP is inserted\&. If \fI__pos\fP 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\&. .PP Definition at line \fB4798\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::replace()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> void \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::reserve (size_type __res_arg = \fC0\fP)" .PP Attempt to preallocate enough memory for specified number of characters\&. .PP \fBParameters\fP .RS 4 \fI__res_arg\fP Number of characters required\&. .RE .PP \fBExceptions\fP .RS 4 \fIstd::length_error\fP If \fI__res_arg\fP exceeds \fCmax_size()\fP\&. .RE .PP 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\&. .PP 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\&. .PP Definition at line \fB3994\fP of file \fBbasic_string\&.tcc\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> void \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::resize (size_type __n)\fC [inline]\fP" .PP Definition at line \fB301\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> void \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::resize (size_type __n, _CharT __c)\fC [inline]\fP" .PP Definition at line \fB294\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::rfind (_CharT __c, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB905\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::rfind (const _CharT * __s, size_type __pos, size_type __n) const\fC [inline]\fP" .PP Definition at line \fB891\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::rfind (const _CharT * __s, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP" .PP Definition at line \fB898\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::rfind (const \fBbasic_string\fP< _CharT, _Traits, _Allocator > & __str, size_type __pos = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB886\fP of file \fBdebug/string\fP\&. .SS "template size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::rfind (\fBconst\fP \fBbasic_string\fP< _CharT, _Traits, _Alloc > & __str, size_type __pos = \fC\fBnpos\fP\fP) const\fC [inline]\fP, \fC [noexcept]\fP, \fC [inherited]\fP" .PP Find last position of a string\&. .PP \fBParameters\fP .RS 4 \fI__str\fP String to locate\&. .br \fI__pos\fP Index of character to search back from (default end)\&. .RE .PP \fBReturns\fP .RS 4 Index of start of last occurrence\&. .RE .PP Starting from \fI__pos\fP, searches backward for value of \fI__str\fP within this string\&. If found, returns the index where it begins\&. If not found, returns npos\&. .PP Definition at line \fB5329\fP of file \fBbasic_string\&.h\fP\&. .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::rfind()\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::find_last_of()\fP, \fBstd::basic_string< _CharT, _Traits, _Alloc >::rfind()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::rfind()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> void \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::shrink_to_fit ()\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB306\fP of file \fBdebug/string\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::size () const\fC [inline]\fP, \fC [noexcept]\fP" .PP Returns the number of characters in the string, not including any null-termination\&. .PP Definition at line \fB3910\fP of file \fBbasic_string\&.h\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> \fBbasic_string\fP \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::substr (size_type __pos = \fC0\fP, size_type __n = \fC\fB_Base::npos\fP\fP) const\fC [inline]\fP" .PP Definition at line \fB1004\fP of file \fBdebug/string\fP\&. .SS "template void \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::swap (\fBbasic_string\fP< _CharT, _Traits, _Alloc > & __s)\fC [noexcept]\fP, \fC [inherited]\fP" .PP Swap contents with another string\&. .PP \fBParameters\fP .RS 4 \fI__s\fP String to swap with\&. .RE .PP Exchanges the contents of this string with that of \fI__s\fP in constant time\&. .PP Definition at line \fB968\fP of file \fBbasic_string\&.tcc\fP\&. .PP Referenced by \fBstd::basic_string< _CharT, _Traits, _Alloc >::assign()\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::operator=()\fP\&. .SS "template, typename _Allocator = std::allocator<_CharT>> void \fB__gnu_debug::basic_string\fP< _CharT, _Traits, _Allocator >::swap (\fBbasic_string\fP< _CharT, _Traits, _Allocator > & __x)\fC [inline]\fP, \fC [noexcept]\fP" .PP Definition at line \fB836\fP of file \fBdebug/string\fP\&. .SH "Friends And Related Symbol Documentation" .PP .SS "template, typename _Allocator = std::allocator<_CharT>> template friend class \fB::__gnu_debug::_Safe_iterator\fP\fC [friend]\fP" .PP Definition at line \fB98\fP of file \fBdebug/string\fP\&. .SH "Member Data Documentation" .PP .SS "template, typename _Allocator = std::allocator<_CharT>> const \fBbasic_string\fP< _CharT, _Traits, _Alloc >::size_type \fBstd::basic_string\fP< _CharT, _Traits, _Alloc >::npos\fC [static]\fP" .PP Value returned by various member functions when they fail\&. .PP Definition at line \fB3360\fP of file \fBbasic_string\&.h\fP\&. .SH "Author" .PP Generated automatically by Doxygen for libstdc++ from the source code\&.