Scroll to navigation

__gnu_debug::basic_string< _CharT, _Traits, _Allocator >(3cxx) __gnu_debug::basic_string< _CharT, _Traits, _Allocator >(3cxx)

NAME

__gnu_debug::basic_string< _CharT, _Traits, _Allocator > - Class std::basic_string with safety/checking/debug instrumentation.

SYNOPSIS

#include <string>

Inherits __gnu_debug::_Safe_container< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware >, and std::basic_string< _CharT, _Traits, _Alloc >.

Public Types


typedef _Allocator allocator_type
typedef __gnu_debug::_Safe_iterator< typename _Base::const_iterator, basic_string > const_iterator
typedef _Base::const_pointer const_pointer
typedef _Base::const_reference const_reference
typedef std::reverse_iterator< const_iterator > const_reverse_iterator
typedef _Base::difference_type difference_type
typedef __gnu_debug::_Safe_iterator< typename _Base::iterator, basic_string > iterator
typedef _Base::pointer pointer
typedef _Base::reference reference
typedef std::reverse_iterator< iterator > reverse_iterator
typedef _Base::size_type size_type
typedef _Traits traits_type
typedef _Traits::char_type value_type

Public Member Functions


basic_string (_Base &&__base) noexcept
template<typename _InputIterator > basic_string (_InputIterator __begin, _InputIterator __end, const _Allocator &__a=_Allocator())
basic_string (basic_string &&)=default
basic_string (const _Allocator &__a) noexcept
basic_string (const _Base &__base)
basic_string (const _CharT *__s, const _Allocator &__a=_Allocator())
basic_string (const _CharT *__s, size_type __n, const _Allocator &__a=_Allocator())
basic_string (const basic_string &)=default
basic_string (const basic_string &__str, size_type __pos, size_type __n=_Base::npos, const _Allocator &__a=_Allocator())
basic_string (size_type __n, _CharT __c, const _Allocator &__a=_Allocator())
basic_string (std::initializer_list< _CharT > __l, const _Allocator &__a=_Allocator())
const _Base & _M_base () const noexcept
_Base & _M_base () noexcept
template<typename _InputIterator > basic_string< _CharT, _Traits, _Alloc > & _M_replace_dispatch (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2, __false_type)
void _M_swap (_Safe_container &__x) noexcept
template<typename _InIterator > _CharT * _S_construct (_InIterator __beg, _InIterator __end, const _Alloc &__a, forward_iterator_tag)
template<typename _InputIterator > basic_string & append (_InputIterator __first, _InputIterator __last)
basic_string & append (const _CharT *__s)
basic_string & append (const _CharT *__s, size_type __n)
basic_string & append (const basic_string &__str)
Append a string to this string. basic_string & append (const basic_string &__str)
basic_string & append (const basic_string &__str, size_type __pos, size_type __n)
basic_string & append (const basic_string &__str, size_type __pos, size_type __n=npos)
Append a substring. basic_string & append (initializer_list< _CharT > __l)
Append an initializer_list of characters. basic_string & append (size_type __n, _CharT __c)
template<typename _InputIterator > basic_string & assign (_InputIterator __first, _InputIterator __last)
basic_string & assign (basic_string &&__str) noexcept(allocator_traits< _Alloc >::is_always_equal::value)
Set value to contents of another string. basic_string & assign (basic_string &&__x) noexcept(noexcept(std::declval< _Base & >().assign(std::move(__x))))
basic_string & assign (const _CharT *__s)
basic_string & assign (const _CharT *__s, size_type __n)
basic_string & assign (const basic_string &__str)
Set value to contents of another string. basic_string & assign (const basic_string &__str, size_type __pos, size_type __n)
basic_string & assign (const basic_string &__str, size_type __pos, size_type __n=npos)
Set value to a substring of a string. basic_string & assign (const basic_string &__x)
basic_string & assign (size_type __n, _CharT __c)
basic_string & assign (std::initializer_list< _CharT > __l)
reference at (size_type __n)
Provides access to the data contained in the string. const_reference at (size_type __n) const
Provides access to the data contained in the string. reference back ()
const_reference back () const noexcept
iterator begin ()
const_iterator begin () const noexcept
const _CharT * c_str () const noexcept
size_type capacity () const noexcept
const_iterator cbegin () const noexcept
const_iterator cend () const noexcept
void clear ()
int compare (const _CharT *__s) const
int compare (const basic_string &__str) const
Compare to a string. int compare (const basic_string &__str) const
int compare (size_type __pos, size_type __n, const basic_string &__str) const
Compare substring to a string. int compare (size_type __pos1, size_type __n1, const _CharT *__s) const
int compare (size_type __pos1, size_type __n1, const _CharT *__s, size_type __n2) const
int compare (size_type __pos1, size_type __n1, const basic_string &__str) const
int compare (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2) const
int compare (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2=npos) const
Compare substring to a substring. size_type copy (_CharT *__s, size_type __n, size_type __pos=0) const
const_reverse_iterator crbegin () const noexcept
const_reverse_iterator crend () const noexcept
const _CharT * data () const noexcept
_GLIBCXX_NODISCARD bool empty () const noexcept
iterator end ()
const_iterator end () const noexcept
iterator erase (iterator __first, iterator __last)
Remove a range of characters. iterator erase (iterator __first, iterator __last)
iterator erase (iterator __position)
Remove one character. iterator erase (iterator __position)
basic_string & erase (size_type __pos=0, size_type __n=_Base::npos)
size_type find (_CharT __c, size_type __pos=0) const noexcept
size_type find (const _CharT *__s, size_type __pos, size_type __n) const
size_type find (const _CharT *__s, size_type __pos=0) const
size_type find (const basic_string &__str, size_type __pos=0) const noexcept
Find position of a string. size_type find (const basic_string &__str, size_type __pos=0) const noexcept
size_type find_first_not_of (_CharT __c, size_type __pos=0) const noexcept
size_type find_first_not_of (const _CharT *__s, size_type __pos, size_type __n) const
size_type find_first_not_of (const _CharT *__s, size_type __pos=0) const
size_type find_first_not_of (const basic_string &__str, size_type __pos=0) const noexcept
Find position of a character not in string. size_type find_first_not_of (const basic_string &__str, size_type __pos=0) const noexcept
size_type find_first_of (_CharT __c, size_type __pos=0) const noexcept
size_type find_first_of (const _CharT *__s, size_type __pos, size_type __n) const
size_type find_first_of (const _CharT *__s, size_type __pos=0) const
size_type find_first_of (const basic_string &__str, size_type __pos=0) const noexcept
Find position of a character of string. size_type find_first_of (const basic_string &__str, size_type __pos=0) const noexcept
size_type find_last_not_of (_CharT __c, size_type __pos=_Base::npos) const noexcept
size_type find_last_not_of (const _CharT *__s, size_type __pos, size_type __n) const
size_type find_last_not_of (const _CharT *__s, size_type __pos=_Base::npos) const
size_type find_last_not_of (const basic_string &__str, size_type __pos=_Base::npos) const noexcept
size_type find_last_not_of (const basic_string &__str, size_type __pos=npos) const noexcept
Find last position of a character not in string. size_type find_last_of (_CharT __c, size_type __pos=_Base::npos) const noexcept
size_type find_last_of (const _CharT *__s, size_type __pos, size_type __n) const
size_type find_last_of (const _CharT *__s, size_type __pos=_Base::npos) const
size_type find_last_of (const basic_string &__str, size_type __pos=_Base::npos) const noexcept
size_type find_last_of (const basic_string &__str, size_type __pos=npos) const noexcept
Find last position of a character of string. reference front ()
const_reference front () const noexcept
allocator_type get_allocator () const noexcept
Return copy of allocator used to construct this string. iterator insert (__const_iterator __p, _CharT __c)
template<typename _InputIterator > iterator insert (__const_iterator __p, _InputIterator __first, _InputIterator __last)
iterator insert (const_iterator __p, size_type __n, _CharT __c)
iterator insert (const_iterator __p, std::initializer_list< _CharT > __l)
iterator insert (iterator __p, _CharT __c)
Insert one character. template<class _InputIterator > void insert (iterator __p, _InputIterator __beg, _InputIterator __end)
Insert a range of characters. void insert (iterator __p, initializer_list< _CharT > __l)
Insert an initializer_list of characters. void insert (iterator __p, size_type __n, _CharT __c)
Insert multiple characters. basic_string & insert (size_type __pos, const _CharT *__s)
basic_string & insert (size_type __pos, const _CharT *__s, size_type __n)
basic_string & insert (size_type __pos, size_type __n, _CharT __c)
basic_string & insert (size_type __pos1, const basic_string &__str)
Insert value of a string. basic_string & insert (size_type __pos1, const basic_string &__str)
basic_string & insert (size_type __pos1, const basic_string &__str, size_type __pos2, size_type __n)
basic_string & insert (size_type __pos1, const basic_string &__str, size_type __pos2, size_type __n=npos)
Insert a substring. size_type length () const noexcept
Returns the number of characters in the string, not including any null-termination. size_type max_size () const noexcept
Returns the size() of the largest possible string. basic_string & operator+= (_CharT __c)
basic_string & operator+= (const _CharT *__s)
basic_string & operator+= (const basic_string &__str)
Append a string to this string. basic_string & operator+= (const basic_string &__str)
basic_string & operator+= (std::initializer_list< _CharT > __l)
basic_string & operator= (_CharT __c)
basic_string & operator= (basic_string &&)=default
basic_string & operator= (const _CharT *__s)
basic_string & operator= (const basic_string &)=default
basic_string & operator= (std::initializer_list< _CharT > __l)
reference operator[] (size_type __pos)
const_reference operator[] (size_type __pos) const noexcept
void pop_back ()
void push_back (_CharT __c)
reverse_iterator rbegin ()
const_reverse_iterator rbegin () const noexcept
reverse_iterator rend ()
const_reverse_iterator rend () const noexcept
template<typename _InputIterator > basic_string & replace (__const_iterator __i1, __const_iterator __i2, _InputIterator __j1, _InputIterator __j2)
basic_string & replace (__const_iterator __i1, __const_iterator __i2, const _CharT *__s)
basic_string & replace (__const_iterator __i1, __const_iterator __i2, const _CharT *__s, size_type __n)
basic_string & replace (__const_iterator __i1, __const_iterator __i2, const basic_string &__str)
basic_string & replace (__const_iterator __i1, __const_iterator __i2, size_type __n, _CharT __c)
basic_string & replace (__const_iterator __i1, __const_iterator __i2, std::initializer_list< _CharT > __l)
basic_string & replace (iterator __i1, iterator __i2, _CharT *__k1, _CharT *__k2)
template<class _InputIterator > basic_string & replace (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2)
Replace range of characters with range. basic_string & replace (iterator __i1, iterator __i2, const _CharT *__k1, const _CharT *__k2)
basic_string & replace (iterator __i1, iterator __i2, const _CharT *__s)
Replace range of characters with C string. basic_string & replace (iterator __i1, iterator __i2, const _CharT *__s, size_type __n)
Replace range of characters with C substring. basic_string & replace (iterator __i1, iterator __i2, const basic_string &__str)
Replace range of characters with string. basic_string & replace (iterator __i1, iterator __i2, const_iterator __k1, const_iterator __k2)
basic_string & replace (iterator __i1, iterator __i2, initializer_list< _CharT > __l)
Replace range of characters with initializer_list. basic_string & replace (iterator __i1, iterator __i2, iterator __k1, iterator __k2)
basic_string & replace (iterator __i1, iterator __i2, size_type __n, _CharT __c)
Replace range of characters with multiple characters. basic_string & replace (size_type __pos, size_type __n, const basic_string &__str)
Replace characters with value from another string. basic_string & replace (size_type __pos, size_type __n1, const _CharT *__s)
basic_string & replace (size_type __pos, size_type __n1, const _CharT *__s, size_type __n2)
basic_string & replace (size_type __pos, size_type __n1, size_type __n2, _CharT __c)
basic_string & replace (size_type __pos1, size_type __n1, const basic_string &__str)
basic_string & replace (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2)
basic_string & replace (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2=npos)
Replace characters with value from another string. void reserve (size_type __res_arg=0)
Attempt to preallocate enough memory for specified number of characters. void resize (size_type __n)
void resize (size_type __n, _CharT __c)
size_type rfind (_CharT __c, size_type __pos=_Base::npos) const noexcept
size_type rfind (const _CharT *__s, size_type __pos, size_type __n) const
size_type rfind (const _CharT *__s, size_type __pos=_Base::npos) const
size_type rfind (const basic_string &__str, size_type __pos=_Base::npos) const noexcept
size_type rfind (const basic_string &__str, size_type __pos=npos) const noexcept
Find last position of a string. void shrink_to_fit () noexcept
size_type size () const noexcept
Returns the number of characters in the string, not including any null-termination. basic_string substr (size_type __pos=0, size_type __n=_Base::npos) const
void swap (basic_string &__s) noexcept(/*conditional */)
Swap contents with another string. void swap (basic_string &__x) noexcept(/*conditional */)

Static Public Attributes


static const size_type npos
Value returned by various member functions when they fail.

Protected Member Functions


_Safe_container & _M_safe () noexcept

Friends


template<typename _ItT , typename _SeqT , typename _CatT > class ::__gnu_debug::_Safe_iterator

Detailed Description

template<typename _CharT, typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>>

class __gnu_debug::basic_string< _CharT, _Traits, _Allocator >"Class std::basic_string with safety/checking/debug instrumentation.

Definition at line 86 of file debug/string.

Member Typedef Documentation

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Allocator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::allocator_type

Definition at line 108 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef __gnu_debug::_Safe_iterator< typename _Base::const_iterator, basic_string> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::const_iterator

Definition at line 119 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Base::const_pointer __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::const_pointer

Definition at line 114 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Base::const_reference __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::const_reference

Definition at line 112 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef std::reverse_iterator<const_iterator> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::const_reverse_iterator

Definition at line 122 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Base::difference_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::difference_type

Definition at line 110 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef __gnu_debug::_Safe_iterator< typename _Base::iterator, basic_string> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::iterator

Definition at line 117 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Base::pointer __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::pointer

Definition at line 113 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Base::reference __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::reference

Definition at line 111 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef std::reverse_iterator<iterator> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::reverse_iterator

Definition at line 121 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Base::size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::size_type

Definition at line 109 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Traits __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::traits_type

Definition at line 106 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> typedef _Traits::char_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::value_type

Definition at line 107 of file debug/string.

Constructor & Destructor Documentation

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string () [inline], [noexcept]

Definition at line 126 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (const _Allocator & __a) [inline], [explicit], [noexcept]

Definition at line 132 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (std::initializer_list< _CharT > __l, const _Allocator & __a = _Allocator()) [inline]

Definition at line 144 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (_Base && __base) [inline], [noexcept]

Definition at line 160 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (const _Base & __base) [inline]

Definition at line 165 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos, size_type __n = _Base::npos, const _Allocator & __a = _Allocator()) [inline]

Definition at line 170 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (const _CharT * __s, size_type __n, const _Allocator & __a = _Allocator()) [inline]

Definition at line 175 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (const _CharT * __s, const _Allocator & __a = _Allocator()) [inline]

Definition at line 179 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (size_type __n, _CharT __c, const _Allocator & __a = _Allocator()) [inline]

Definition at line 183 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> template<typename _InputIterator > __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::basic_string (_InputIterator __begin, _InputIterator __end, const _Allocator & __a = _Allocator()) [inline]

Definition at line 188 of file debug/string.

Member Function Documentation

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const _Base & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::_M_base () const [inline], [noexcept]

Definition at line 1051 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> _Base & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::_M_base () [inline], [noexcept]

Definition at line 1048 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > template<typename _InputIterator > basic_string< _CharT, _Traits, _Alloc > & std::basic_string< _CharT, _Traits, _Alloc >::_M_replace_dispatch (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2, __false_type) [inherited]

Definition at line 1105 of file basic_string.tcc.

template<typename _SafeContainer , typename _Alloc , template< typename > class _SafeBase, bool _IsCxx11AllocatorAware = true> _Safe_container & __gnu_debug::_Safe_container< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware >::_M_safe () [inline], [protected], [noexcept], [inherited]

Definition at line 52 of file safe_container.h.

template<typename _SafeContainer , typename _Alloc , template< typename > class _SafeBase, bool _IsCxx11AllocatorAware = true> void __gnu_debug::_Safe_container< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware >::_M_swap (_Safe_container< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware > & __x) [inline], [noexcept], [inherited]

Definition at line 104 of file safe_container.h.

template<typename _CharT , typename _Traits , typename _Alloc > template<typename _InIterator > _CharT * std::basic_string< _CharT, _Traits, _Alloc >::_S_construct (_InIterator __beg, _InIterator __end, const _Alloc & __a, forward_iterator_tag) [inherited]

Definition at line 563 of file basic_string.tcc.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> template<typename _InputIterator > basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::append (_InputIterator __first, _InputIterator __last) [inline]

Definition at line 448 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::append (const _CharT * __s) [inline]

Definition at line 430 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::append (const _CharT * __s, size_type __n) [inline]

Definition at line 421 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string< _CharT, _Traits, _Alloc > & std::basic_string< _CharT, _Traits, _Alloc >::append (const basic_string< _CharT, _Traits, _Alloc > & __str) [inherited]

Append a string to this string.

Parameters

__str The string to append.

Returns

Reference to this string.

Definition at line 774 of file basic_string.tcc.

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::append(), std::basic_string< _CharT, _Traits, _Alloc >::append(), std::basic_string< _CharT, _Traits, _Alloc >::operator+=(), std::basic_string< _CharT, _Traits, _Alloc >::operator+=(), and std::basic_string< _CharT, _Traits, _Alloc >::operator+=().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::append (const basic_string< _CharT, _Traits, _Allocator > & __str) [inline]

Definition at line 405 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::append (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos, size_type __n) [inline]

Definition at line 413 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string< _CharT, _Traits, _Alloc > & std::basic_string< _CharT, _Traits, _Alloc >::append (const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos, size_type __n = npos) [inherited]

Append a substring.

Parameters

__str The string to append.
__pos Index of the first character of str to append.
__n The number of characters to append.

Returns

Reference to this string.

Exceptions

std::out_of_range if __pos is not a valid index.

This function appends __n characters from __str starting at __pos to this string. If __n is is larger than the number of available characters in __str, the remainder of __str is appended.

Definition at line 791 of file basic_string.tcc.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::append (initializer_list< _CharT > __l) [inline], [inherited]

Append an initializer_list of characters.

Parameters

__l The initializer_list of characters to append.

Returns

Reference to this string.

Definition at line 4273 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::append().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::append (size_type __n, _CharT __c) [inline]

Definition at line 439 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> template<typename _InputIterator > basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign (_InputIterator __first, _InputIterator __last) [inline]

Definition at line 527 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::assign (basic_string< _CharT, _Traits, _Alloc > && __str) [inline], [noexcept], [inherited]

Set value to contents of another string.

Parameters

__str Source string to use.

Returns

Reference to this string.

This function sets this string to the exact contents of __str. __str is a valid, but unspecified string.

Definition at line 4355 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::swap().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign (basic_string< _CharT, _Traits, _Allocator > && __x) [inline], [noexcept]

Definition at line 482 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign (const _CharT * __s) [inline]

Definition at line 509 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign (const _CharT * __s, size_type __n) [inline]

Definition at line 500 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string< _CharT, _Traits, _Alloc > & std::basic_string< _CharT, _Traits, _Alloc >::assign (const basic_string< _CharT, _Traits, _Alloc > & __str) [inherited]

Set value to contents of another string.

Parameters

__str Source string to use.

Returns

Reference to this string.

Definition at line 692 of file basic_string.tcc.

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::operator=(), std::basic_string< _CharT, _Traits, _Alloc >::operator=(), std::basic_string< _CharT, _Traits, _Alloc >::operator=(), and std::basic_string< _CharT, _Traits, _Alloc >::operator=().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos, size_type __n) [inline]

Definition at line 492 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::assign (const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos, size_type __n = npos) [inline], [inherited]

Set value to a substring of a string.

Parameters

__str The string to use.
__pos Index of the first character of str.
__n Number of characters to use.

Returns

Reference to this string.

Exceptions

std::out_of_range if pos is not a valid index.

This function sets this string to the substring of __str consisting of __n characters at __pos. If __n is is larger than the number of available characters in __str, the remainder of __str is used.

Definition at line 4377 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::assign().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign (const basic_string< _CharT, _Traits, _Allocator > & __x) [inline]

Definition at line 473 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign (size_type __n, _CharT __c) [inline]

Definition at line 518 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign (std::initializer_list< _CharT > __l) [inline]

Definition at line 544 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> reference std::basic_string< _CharT, _Traits, _Alloc >::at (size_type __n) [inline]

Provides access to the data contained in the string.

Parameters

__n The index of the character to access.

Returns

Read/write reference to the character.

Exceptions

std::out_of_range If n is an invalid index.

This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails. Success results in unsharing the string.

Definition at line 4099 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_reference std::basic_string< _CharT, _Traits, _Alloc >::at (size_type __n) const [inline]

Provides access to the data contained in the string.

Parameters

__n The index of the character to access.

Returns

Read-only (const) reference to the character.

Exceptions

std::out_of_range If n is an invalid index.

This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails.

Definition at line 4077 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> reference std::basic_string< _CharT, _Traits, _Alloc >::back () [inline]

Returns a read/write reference to the data at the last element of the string.

Definition at line 4138 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_reference std::basic_string< _CharT, _Traits, _Alloc >::back () const [inline], [noexcept]

Returns a read-only (constant) reference to the data at the last element of the string.

Definition at line 4149 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::begin () [inline]

Definition at line 239 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::begin () const [inline], [noexcept]

Definition at line 243 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const _CharT * __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::c_str () const [inline], [noexcept]

Definition at line 845 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type std::basic_string< _CharT, _Traits, _Alloc >::capacity () const [inline], [noexcept]

Returns the total number of characters that the string can hold before needing to allocate more memory.

Definition at line 3973 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::cbegin () const [inline], [noexcept]

Definition at line 272 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::cend () const [inline], [noexcept]

Definition at line 276 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> void __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::clear () [inline]

Definition at line 325 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> int __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::compare (const _CharT * __s) const [inline]

Definition at line 1022 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > int std::basic_string< _CharT, _Traits, _Alloc >::compare (const basic_string< _CharT, _Traits, _Alloc > & __str) const [inline], [inherited]

Compare to a string.

Parameters

__str String to compare against.

Returns

Integer < 0, 0, or > 0.

Returns an integer < 0 if this string is ordered before __str, 0 if their values are equivalent, or > 0 if this string is ordered after __str. Determines the effective length rlen of the strings to compare as the smallest of size() and str.size(). The function then compares the two strings by calling traits::compare(data(), str.data(),rlen). If the result of the comparison is nonzero returns it, otherwise the shorter one is ordered first.

Definition at line 5759 of file basic_string.h.

References std::min(), and std::basic_string< _CharT, _Traits, _Alloc >::size().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> int __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::compare (const basic_string< _CharT, _Traits, _Allocator > & __str) const [inline]

Definition at line 1008 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > int std::basic_string< _CharT, _Traits, _Alloc >::compare (size_type __pos, size_type __n, const basic_string< _CharT, _Traits, _Alloc > & __str) const [inherited]

Compare substring to a string.

Parameters

__pos Index of first character of substring.
__n Number of characters in substring.
__str String to compare against.

Returns

Integer < 0, 0, or > 0.

Form the substring of this string from the __n characters starting at __pos. Returns an integer < 0 if the substring is ordered before __str, 0 if their values are equivalent, or > 0 if the substring is ordered after __str. Determines the effective length rlen of the strings to compare as the smallest of the length of the substring and __str.size(). The function then compares the two strings by calling traits::compare(substring.data(),str.data(),rlen). If the result of the comparison is nonzero returns it, otherwise the shorter one is ordered first.

Definition at line 1385 of file basic_string.tcc.

References std::min().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> int __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::compare (size_type __pos1, size_type __n1, const _CharT * __s) const [inline]

Definition at line 1031 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> int __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::compare (size_type __pos1, size_type __n1, const _CharT * __s, size_type __n2) const [inline]

Definition at line 1040 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> int __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::compare (size_type __pos1, size_type __n1, const basic_string< _CharT, _Traits, _Allocator > & __str) const [inline]

Definition at line 1012 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> int __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::compare (size_type __pos1, size_type __n1, const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos2, size_type __n2) const [inline]

Definition at line 1017 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > int std::basic_string< _CharT, _Traits, _Alloc >::compare (size_type __pos1, size_type __n1, const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos2, size_type __n2 = npos) const [inherited]

Compare substring to a substring.

Parameters

__pos1 Index of first character of substring.
__n1 Number of characters in substring.
__str String to compare against.
__pos2 Index of first character of substring of str.
__n2 Number of characters in substring of str.

Returns

Integer < 0, 0, or > 0.

Form the substring of this string from the __n1 characters starting at __pos1. Form the substring of __str from the __n2 characters starting at __pos2. Returns an integer < 0 if this substring is ordered before the substring of __str, 0 if their values are equivalent, or > 0 if this substring is ordered after the substring of __str. Determines the effective length rlen of the strings to compare as the smallest of the lengths of the substrings. The function then compares the two strings by calling traits::compare(substring.data(),str.substr(pos2,n2).data(),rlen). If the result of the comparison is nonzero returns it, otherwise the shorter one is ordered first.

Definition at line 1400 of file basic_string.tcc.

References std::min().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::copy (_CharT * __s, size_type __n, size_type __pos = 0) const [inline]

Definition at line 829 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_reverse_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::crbegin () const [inline], [noexcept]

Definition at line 280 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_reverse_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::crend () const [inline], [noexcept]

Definition at line 284 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const _CharT * __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::data () const [inline], [noexcept]

Definition at line 853 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> _GLIBCXX_NODISCARD bool std::basic_string< _CharT, _Traits, _Alloc >::empty () const [inline], [noexcept]

Returns true if the string is empty. Equivalent to *this == ''.

Definition at line 4023 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::end () [inline]

Definition at line 247 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::end () const [inline], [noexcept]

Definition at line 251 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string< _CharT, _Traits, _Alloc >::iterator std::basic_string< _CharT, _Traits, _Alloc >::erase (iterator __first, iterator __last) [inherited]

Remove a range of characters.

Parameters

__first Iterator referencing the first character to remove.
__last Iterator referencing the end of the range.

Returns

Iterator referencing location of first after removal.

Removes the characters in the range [first,last) from this string. The value of the string doesn't change if an error is thrown.

Definition at line 840 of file basic_string.tcc.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::erase (iterator __first, iterator __last) [inline]

Definition at line 688 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > iterator std::basic_string< _CharT, _Traits, _Alloc >::erase (iterator __position) [inline], [inherited]

Remove one character.

Parameters

__position Iterator referencing the character to remove.

Returns

iterator referencing same location after removal.

Removes the character at __position from this string. The value of the string doesn't change if an error is thrown.

Definition at line 4722 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::erase (iterator __position) [inline]

Definition at line 679 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::erase (size_type __pos = 0, size_type __n = _Base::npos) [inline]

Definition at line 671 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find (_CharT __c, size_type __pos = 0) const [inline], [noexcept]

Definition at line 882 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find (const _CharT * __s, size_type __pos, size_type __n) const [inline]

Definition at line 868 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find (const _CharT * __s, size_type __pos = 0) const [inline]

Definition at line 875 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > size_type std::basic_string< _CharT, _Traits, _Alloc >::find (const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = 0) const [inline], [noexcept], [inherited]

Find position of a string.

Parameters

__str String to locate.
__pos Index of character to search from (default 0).

Returns

Index of start of first occurrence.

Starting from __pos, searches forward for value of __str within this string. If found, returns the index where it begins. If not found, returns npos.

Definition at line 5267 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::find().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos = 0) const [inline], [noexcept]

Definition at line 863 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_first_not_of (_CharT __c, size_type __pos = 0) const [inline], [noexcept]

Definition at line 975 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_first_not_of (const _CharT * __s, size_type __pos, size_type __n) const [inline]

Definition at line 961 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_first_not_of (const _CharT * __s, size_type __pos = 0) const [inline]

Definition at line 968 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > size_type std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of (const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = 0) const [inline], [noexcept], [inherited]

Find position of a character not in string.

Parameters

__str String containing characters to avoid.
__pos Index of character to search from (default 0).

Returns

Index of first occurrence.

Starting from __pos, searches forward for a character not contained in __str within this string. If found, returns the index where it was found. If not found, returns npos.

Definition at line 5575 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of().

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_first_not_of (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos = 0) const [inline], [noexcept]

Definition at line 956 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_first_of (_CharT __c, size_type __pos = 0) const [inline], [noexcept]

Definition at line 928 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_first_of (const _CharT * __s, size_type __pos, size_type __n) const [inline]

Definition at line 914 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_first_of (const _CharT * __s, size_type __pos = 0) const [inline]

Definition at line 921 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > size_type std::basic_string< _CharT, _Traits, _Alloc >::find_first_of (const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = 0) const [inline], [noexcept], [inherited]

Find position of a character of string.

Parameters

__str String containing characters to locate.
__pos Index of character to search from (default 0).

Returns

Index of first occurrence.

Starting from __pos, searches forward for one of the characters of __str within this string. If found, returns the index where it was found. If not found, returns npos.

Definition at line 5408 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::find_first_of().

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_first_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_first_of().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_first_of (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos = 0) const [inline], [noexcept]

Definition at line 909 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_last_not_of (_CharT __c, size_type __pos = _Base::npos) const [inline], [noexcept]

Definition at line 999 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_last_not_of (const _CharT * __s, size_type __pos, size_type __n) const [inline]

Definition at line 985 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_last_not_of (const _CharT * __s, size_type __pos = _Base::npos) const [inline]

Definition at line 992 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_last_not_of (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos = _Base::npos) const [inline], [noexcept]

Definition at line 979 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > size_type std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of (const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = npos) const [inline], [noexcept], [inherited]

Find last position of a character not in string.

Parameters

__str String containing characters to avoid.
__pos Index of character to search back from (default end).

Returns

Index of last occurrence.

Starting from __pos, searches backward for a character not contained in __str within this string. If found, returns the index where it was found. If not found, returns npos.

Definition at line 5657 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of().

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_last_of (_CharT __c, size_type __pos = _Base::npos) const [inline], [noexcept]

Definition at line 951 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_last_of (const _CharT * __s, size_type __pos, size_type __n) const [inline]

Definition at line 937 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_last_of (const _CharT * __s, size_type __pos = _Base::npos) const [inline]

Definition at line 944 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::find_last_of (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos = _Base::npos) const [inline], [noexcept]

Definition at line 932 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > size_type std::basic_string< _CharT, _Traits, _Alloc >::find_last_of (const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = npos) const [inline], [noexcept], [inherited]

Find last position of a character of string.

Parameters

__str String containing characters to locate.
__pos Index of character to search back from (default end).

Returns

Index of last occurrence.

Starting from __pos, searches backward for one of the characters of __str within this string. If found, returns the index where it was found. If not found, returns npos.

Definition at line 5492 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::find_last_of().

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_last_of().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> reference std::basic_string< _CharT, _Traits, _Alloc >::front () [inline]

Returns a read/write reference to the data at the first element of the string.

Definition at line 4116 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_reference std::basic_string< _CharT, _Traits, _Alloc >::front () const [inline], [noexcept]

Returns a read-only (constant) reference to the data at the first element of the string.

Definition at line 4127 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> allocator_type std::basic_string< _CharT, _Traits, _Alloc >::get_allocator () const [inline], [noexcept]

Return copy of allocator used to construct this string.

Definition at line 5237 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (__const_iterator __p, _CharT __c) [inline]

Definition at line 596 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> template<typename _InputIterator > iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (__const_iterator __p, _InputIterator __first, _InputIterator __last) [inline]

Definition at line 631 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (const_iterator __p, size_type __n, _CharT __c) [inline]

Definition at line 606 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (const_iterator __p, std::initializer_list< _CharT > __l) [inline]

Definition at line 655 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > iterator std::basic_string< _CharT, _Traits, _Alloc >::insert (iterator __p, _CharT __c) [inline], [inherited]

Insert one character.

Parameters

__p Iterator referencing position in string to insert at.
__c The character to insert.

Returns

Iterator referencing newly inserted char.

Exceptions

std::length_error If new length exceeds max_size().

Inserts character __c at position referenced by __p. If adding character causes the length to exceed max_size(), length_error is thrown. If __p is beyond end of string, out_of_range is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4646 of file basic_string.h.

template<typename _CharT , typename _Traits , typename _Alloc > template<class _InputIterator > void std::basic_string< _CharT, _Traits, _Alloc >::insert (iterator __p, _InputIterator __beg, _InputIterator __end) [inline], [inherited]

Insert a range of characters.

Parameters

__p Iterator referencing location in string to insert at.
__beg Start of range.
__end End of range.

Exceptions

std::length_error If new length exceeds max_size().

Inserts characters in range [__beg,__end). If adding characters causes the length to exceed max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4511 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::replace().

template<typename _CharT , typename _Traits , typename _Alloc > void std::basic_string< _CharT, _Traits, _Alloc >::insert (iterator __p, initializer_list< _CharT > __l) [inline], [inherited]

Insert an initializer_list of characters.

Parameters

__p Iterator referencing location in string to insert at.
__l The initializer_list of characters to insert.

Exceptions

std::length_error If new length exceeds max_size().

Definition at line 4522 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::insert().

template<typename _CharT , typename _Traits , typename _Alloc > void std::basic_string< _CharT, _Traits, _Alloc >::insert (iterator __p, size_type __n, _CharT __c) [inline], [inherited]

Insert multiple characters.

Parameters

__p Iterator referencing location in string to insert at.
__n Number of characters to insert
__c The character to insert.

Exceptions

std::length_error If new length exceeds max_size().

Inserts __n copies of character __c starting at the position referenced by iterator __p. If adding characters causes the length to exceed max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4494 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::replace().

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), and std::basic_string< _CharT, _Traits, _Alloc >::insert().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (size_type __pos, const _CharT * __s) [inline]

Definition at line 579 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (size_type __pos, const _CharT * __s, size_type __n) [inline]

Definition at line 570 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (size_type __pos, size_type __n, _CharT __c) [inline]

Definition at line 588 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::insert (size_type __pos1, const basic_string< _CharT, _Traits, _Alloc > & __str) [inline], [inherited]

Insert value of a string.

Parameters

__pos1 Iterator referencing location in string to insert at.
__str The string to insert.

Returns

Reference to this string.

Exceptions

std::length_error If new length exceeds max_size().

Inserts value of __str starting at __pos1. If adding characters causes the length to exceed max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4542 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::insert().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (size_type __pos1, const basic_string< _CharT, _Traits, _Allocator > & __str) [inline]

Definition at line 553 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::insert (size_type __pos1, const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos2, size_type __n) [inline]

Definition at line 561 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::insert (size_type __pos1, const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos2, size_type __n = npos) [inline], [inherited]

Insert a substring.

Parameters

__pos1 Iterator referencing location in string to insert at.
__str The string to insert.
__pos2 Start of characters in str to insert.
__n Number of characters to insert.

Returns

Reference to this string.

Exceptions

std::length_error If new length exceeds max_size().
std::out_of_range If pos1 > size() or __pos2 > str.size().

Starting at pos1, insert __n character of __str beginning with __pos2. If adding characters causes the length to exceed max_size(), length_error is thrown. If __pos1 is beyond the end of this string or __pos2 is beyond the end of __str, out_of_range is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4564 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::insert().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type std::basic_string< _CharT, _Traits, _Alloc >::length () const [inline], [noexcept]

Returns the number of characters in the string, not including any null-termination.

Definition at line 3916 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type std::basic_string< _CharT, _Traits, _Alloc >::max_size () const [inline], [noexcept]

Returns the size() of the largest possible string.

Definition at line 3921 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator+= (_CharT __c) [inline]

Definition at line 387 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator+= (const _CharT * __s) [inline]

Definition at line 378 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::operator+= (const basic_string< _CharT, _Traits, _Alloc > & __str) [inline], [inherited]

Append a string to this string.

Parameters

__str The string to append.

Returns

Reference to this string.

Definition at line 4163 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::append().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator+= (const basic_string< _CharT, _Traits, _Allocator > & __str) [inline]

Definition at line 370 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator+= (std::initializer_list< _CharT > __l) [inline]

Definition at line 396 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator= (_CharT __c) [inline]

Definition at line 220 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator= (const _CharT * __s) [inline]

Definition at line 211 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator= (std::initializer_list< _CharT > __l) [inline]

Definition at line 229 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> reference __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator[] (size_type __pos) [inline]

Definition at line 346 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_reference __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::operator[] (size_type __pos) const [inline], [noexcept]

Definition at line 335 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> void __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::pop_back () [inline]

Definition at line 701 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> void __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::push_back (_CharT __c) [inline]

Definition at line 466 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> reverse_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::rbegin () [inline]

Definition at line 255 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_reverse_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::rbegin () const [inline], [noexcept]

Definition at line 259 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> reverse_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::rend () [inline]

Definition at line 263 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const_reverse_iterator __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::rend () const [inline], [noexcept]

Definition at line 267 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> template<typename _InputIterator > basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (__const_iterator __i1, __const_iterator __i2, _InputIterator __j1, _InputIterator __j2) [inline]

Definition at line 797 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (__const_iterator __i1, __const_iterator __i2, const _CharT * __s) [inline]

Definition at line 775 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (__const_iterator __i1, __const_iterator __i2, const _CharT * __s, size_type __n) [inline]

Definition at line 764 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (__const_iterator __i1, __const_iterator __i2, const basic_string< _CharT, _Traits, _Allocator > & __str) [inline]

Definition at line 754 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (__const_iterator __i1, __const_iterator __i2, size_type __n, _CharT __c) [inline]

Definition at line 786 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (__const_iterator __i1, __const_iterator __i2, std::initializer_list< _CharT > __l) [inline]

Definition at line 818 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, _CharT * __k1, _CharT * __k2) [inline], [inherited]

Definition at line 4983 of file basic_string.h.

template<typename _CharT , typename _Traits , typename _Alloc > template<class _InputIterator > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2) [inline], [inherited]

Replace range of characters with range.

Parameters

__i1 Iterator referencing start of range to replace.
__i2 Iterator referencing end of range to replace.
__k1 Iterator referencing start of range to insert.
__k2 Iterator referencing end of range to insert.

Returns

Reference to this string.

Exceptions

std::length_error If new length exceeds max_size().

Removes the characters in the range [__i1,__i2). In place, characters in the range [__k1,__k2) are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4970 of file basic_string.h.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, const _CharT * __k1, const _CharT * __k2) [inline], [inherited]

Definition at line 4993 of file basic_string.h.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, const _CharT * __s) [inline], [inherited]

Replace range of characters with C string.

Parameters

__i1 Iterator referencing start of range to replace.
__i2 Iterator referencing end of range to replace.
__s C string value to insert.

Returns

Reference to this string.

Exceptions

std::length_error If new length exceeds max_size().

Removes the characters in the range [__i1,__i2). In place, the characters of __s are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4925 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::replace().

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, const _CharT * __s, size_type __n) [inline], [inherited]

Replace range of characters with C substring.

Parameters

__i1 Iterator referencing start of range to replace.
__i2 Iterator referencing end of range to replace.
__s C string value to insert.
__n Number of characters from s to insert.

Returns

Reference to this string.

Exceptions

std::length_error If new length exceeds max_size().

Removes the characters in the range [__i1,__i2). In place, the first __n characters of __s are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4904 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::replace().

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, const basic_string< _CharT, _Traits, _Alloc > & __str) [inline], [inherited]

Replace range of characters with string.

Parameters

__i1 Iterator referencing start of range to replace.
__i2 Iterator referencing end of range to replace.
__str String value to insert.

Returns

Reference to this string.

Exceptions

std::length_error If new length exceeds max_size().

Removes the characters in the range [__i1,__i2). In place, the value of __str is inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4885 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::replace().

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, const_iterator __k1, const_iterator __k2) [inline], [inherited]

Definition at line 5014 of file basic_string.h.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, initializer_list< _CharT > __l) [inline], [inherited]

Replace range of characters with initializer_list.

Parameters

__i1 Iterator referencing start of range to replace.
__i2 Iterator referencing end of range to replace.
__l The initializer_list of characters to insert.

Returns

Reference to this string.

Exceptions

std::length_error If new length exceeds max_size().

Removes the characters in the range [__i1,__i2). In place, characters in the range [__k1,__k2) are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 5039 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::replace().

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, iterator __k1, iterator __k2) [inline], [inherited]

Definition at line 5004 of file basic_string.h.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (iterator __i1, iterator __i2, size_type __n, _CharT __c) [inline], [inherited]

Replace range of characters with multiple characters.

Parameters

__i1 Iterator referencing start of range to replace.
__i2 Iterator referencing end of range to replace.
__n Number of characters to insert.
__c Character to insert.

Returns

Reference to this string.

Exceptions

std::length_error If new length exceeds max_size().

Removes the characters in the range [__i1,__i2). In place, __n copies of __c are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4946 of file basic_string.h.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (size_type __pos, size_type __n, const basic_string< _CharT, _Traits, _Alloc > & __str) [inline], [inherited]

Replace characters with value from another string.

Parameters

__pos Index of first character to replace.
__n Number of characters to be replaced.
__str String to insert.

Returns

Reference to this string.

Exceptions

std::out_of_range If pos is beyond the end of this string.
std::length_error If new length exceeds max_size().

Removes the characters in the range [__pos,__pos+__n) from this string. In place, the value of __str is inserted. If __pos is beyond end of string, out_of_range is thrown. If the length of the result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4776 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::replace().

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::append(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), std::basic_string< _CharT, _Traits, _Alloc >::replace(), and std::basic_string< _CharT, _Traits, _Alloc >::replace().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (size_type __pos, size_type __n1, const _CharT * __s) [inline]

Definition at line 737 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (size_type __pos, size_type __n1, const _CharT * __s, size_type __n2) [inline]

Definition at line 727 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (size_type __pos, size_type __n1, size_type __n2, _CharT __c) [inline]

Definition at line 746 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (size_type __pos1, size_type __n1, const basic_string< _CharT, _Traits, _Allocator > & __str) [inline]

Definition at line 710 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string & __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::replace (size_type __pos1, size_type __n1, const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos2, size_type __n2) [inline]

Definition at line 718 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace (size_type __pos1, size_type __n1, const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos2, size_type __n2 = npos) [inline], [inherited]

Replace characters with value from another string.

Parameters

__pos1 Index of first character to replace.
__n1 Number of characters to be replaced.
__str String to insert.
__pos2 Index of first character of str to use.
__n2 Number of characters from str to use.

Returns

Reference to this string.

Exceptions

std::out_of_range If __pos1 > size() or __pos2 > __str.size().
std::length_error If new length exceeds max_size().

Removes the characters in the range [__pos1,__pos1 + n) from this string. In place, the value of __str is inserted. If __pos is beyond end of string, out_of_range is thrown. If the length of the result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 4798 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::replace().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> void std::basic_string< _CharT, _Traits, _Alloc >::reserve (size_type __res_arg = 0)

Attempt to preallocate enough memory for specified number of characters.

Parameters

__res_arg Number of characters required.

Exceptions

std::length_error If __res_arg exceeds max_size().

This function attempts to reserve enough memory for the string to hold the specified number of characters. If the number requested is more than max_size(), length_error is thrown.

The advantage of this function is that if optimal code is a necessity and the user can determine the string length that will be required, the user can reserve the memory in advance, and thus prevent a possible reallocation of memory and copying of string data.

Definition at line 3994 of file basic_string.tcc.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> void __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::resize (size_type __n) [inline]

Definition at line 301 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> void __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::resize (size_type __n, _CharT __c) [inline]

Definition at line 294 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::rfind (_CharT __c, size_type __pos = _Base::npos) const [inline], [noexcept]

Definition at line 905 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::rfind (const _CharT * __s, size_type __pos, size_type __n) const [inline]

Definition at line 891 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::rfind (const _CharT * __s, size_type __pos = _Base::npos) const [inline]

Definition at line 898 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::rfind (const basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos = _Base::npos) const [inline], [noexcept]

Definition at line 886 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > size_type std::basic_string< _CharT, _Traits, _Alloc >::rfind (const basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = npos) const [inline], [noexcept], [inherited]

Find last position of a string.

Parameters

__str String to locate.
__pos Index of character to search back from (default end).

Returns

Index of start of last occurrence.

Starting from __pos, searches backward for value of __str within this string. If found, returns the index where it begins. If not found, returns npos.

Definition at line 5329 of file basic_string.h.

References std::basic_string< _CharT, _Traits, _Alloc >::rfind().

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), std::basic_string< _CharT, _Traits, _Alloc >::rfind(), and std::basic_string< _CharT, _Traits, _Alloc >::rfind().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> void __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::shrink_to_fit () [inline], [noexcept]

Definition at line 306 of file debug/string.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> size_type std::basic_string< _CharT, _Traits, _Alloc >::size () const [inline], [noexcept]

Returns the number of characters in the string, not including any null-termination.

Definition at line 3910 of file basic_string.h.

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> basic_string __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::substr (size_type __pos = 0, size_type __n = _Base::npos) const [inline]

Definition at line 1004 of file debug/string.

template<typename _CharT , typename _Traits , typename _Alloc > void std::basic_string< _CharT, _Traits, _Alloc >::swap (basic_string< _CharT, _Traits, _Alloc > & __s) [noexcept], [inherited]

Swap contents with another string.

Parameters

__s String to swap with.

Exchanges the contents of this string with that of __s in constant time.

Definition at line 968 of file basic_string.tcc.

Referenced by std::basic_string< _CharT, _Traits, _Alloc >::assign(), and std::basic_string< _CharT, _Traits, _Alloc >::operator=().

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> void __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::swap (basic_string< _CharT, _Traits, _Allocator > & __x) [inline], [noexcept]

Definition at line 836 of file debug/string.

Friends And Related Symbol Documentation

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> template<typename _ItT , typename _SeqT , typename _CatT > friend class ::__gnu_debug::_Safe_iterator [friend]

Definition at line 98 of file debug/string.

Member Data Documentation

template<typename _CharT , typename _Traits = std::char_traits<_CharT>, typename _Allocator = std::allocator<_CharT>> const basic_string< _CharT, _Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc >::npos [static]

Value returned by various member functions when they fail.

Definition at line 3360 of file basic_string.h.

Author

Generated automatically by Doxygen for libstdc++ from the source code.

libstdc++