replace() [20/30]

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

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

      {
      _GLIBCXX_DEBUG_PEDASSERT(_M_ibegin() <= __i1 && __i1 <= __i2
                         && __i2 <= _M_iend());
      return _M_replace_aux(__i1 - _M_ibegin(), __i2 - __i1, __n, __c);
      }