insert() [14/18]

template<typename _CharT, typename _Traits, typename _Alloc>

basic_string & std::basic_string< _CharT, _Traits, _Alloc >::insert ( size_type __pos, size_type __n, _CharT __c )

inline

Insert multiple characters.

Parameters

__pos	Index in string to insert at.
__n	Number of characters to insert
__c	The character to insert.

Returns

Reference to this string.

Exceptions

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

Inserts __n copies of character __c starting at index __pos. If adding characters causes the length to exceed max_size(), length_error is thrown. If __pos > length(), out_of_range is thrown. The value of the string doesn't change if an error is thrown.

Definition at line 1780 of file cow_string.h.

      { return _M_replace_aux(_M_check(__pos, "basic_string::insert"),
                        size_type(0), __n, __c); }