insert() [5/18]

template<typename _CharT, typename _Traits, typename _Alloc>

iterator std::basic_string< _CharT, _Traits, _Alloc >::insert ( iterator __p, _CharT __c )

inline

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 1798 of file cow_string.h.

      {
      _GLIBCXX_DEBUG_PEDASSERT(__p >= _M_ibegin() && __p <= _M_iend());
      const size_type __pos = __p - _M_ibegin();
      _M_replace_aux(__pos, size_type(0), size_type(1), __c);
      _M_rep()->_M_set_leaked();
      return iterator(_M_data() + __pos);
      }