insert() [18/18]

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

Insert a substring.

Parameters

__pos1	Position 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 1716 of file cow_string.h.

      { return this->insert(__pos1, __str._M_data()
                      + __str._M_check(__pos2, "basic_string::insert"),
                      __str._M_limit(__pos2, __n)); }