cpp/string/basic string/insert range

Inserts characters from the range before the element (if any) pointed by.

Equivalent to

If is not a valid iterator on, the behavior is undefined.

Return value
An iterator which refers to the first inserted character, or if no characters were inserted because  was empty.

Complexity
Linear in size of.

Exceptions
Throws std if the resultant string size would exceed.

If throws an exception, it is rethrown.