cpp/string/basic string/insert

Inserts characters into the string.

@1@ Inserts copies of character  at the position.

@2@ Inserts null-terminated character string pointed to by at the position. The length of the string is determined by the first null character using.

@3@ Inserts the characters in the range at the position. The range can contain null characters.

@4@ Inserts string at the position.

@5@ Inserts a string, obtained by at the position.

@6@ Inserts character before the character pointed by.

@7@ Inserts copies of character  before the element (if any) pointed by.

@8@ Inserts characters from the range before the element (if any) pointed by, as if by.

@9@ Inserts elements from initializer list before the element (if any) pointed by.

@10@

@11@

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

Return value
@1-5@

@6-9@ An iterator which refers to the copy of the first inserted character or if no characters were inserted ( or  or )

@10,11@

Exceptions
@1-4,10@ Throws std if. @5@ Throws std if or if. @11@ Throws std if or if.

In all cases, throws std if where  is the number of characters that will be inserted.