cpp/container/multiset/insert

Inserts element(s) into the container. The order of the remaining equivalent elements is preserved.

@1,2@ Inserts. If the container has elements with equivalent key, inserts at the upper bound of that range.

@3,4@ inserts in the position as close as possible to the position just prior to.

@5@ inserts elements from range.

@6@ inserts elements from initializer list.

Return value
@1-4@ Returns an iterator to the inserted element.

@5,6@ (none)

Exceptions
@1-4,7,8@ If an exception is thrown by any operation, the insertion has no effect.

@5,6@ No exception safety guarantee.

Complexity
@1,2,7@.

@3,4,8@ Amortized constant if the insertion happens in the position just before, otherwise.

@5,6@, where is the number of elements to insert.