insert() [4/18]

template<typename _CharT, typename _Traits, typename _Alloc>

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

inlineconstexpr

Insert multiple characters.

Parameters

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

Returns

Iterator referencing the first inserted char.

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 2033 of file basic_string.h.

      {
      _GLIBCXX_DEBUG_PEDASSERT(__p >= begin() && __p <= end());
      const size_type __pos = __p - begin();
      this->replace(__p, __p, __n, __c);
      return iterator(this->_M_data() + __pos);
      }

Referenced by std::money_get< _CharT, _InIter >::_M_extract(), std::money_put< _CharT, _OutIter >::_M_insert(), std::basic_string< _CharT >::insert(), std::basic_string< _CharT >::insert(), std::basic_string< _CharT >::insert(), std::basic_string< _CharT >::insert(), and std::basic_string< _CharT >::insert().

Here is the caller graph for this function: