cpp/container/multimap/insert

Inserts element(s) into the container.

@1-3@ inserts. If the container has elements with equivalent key, inserts at the upper bound of that range. The overload is equivalent to  and only participates in overload resolution if.

@4-6@ inserts in the position as close as possible to the position just prior to. The overload is equivalent to  and only participates in overload resolution if.

@7@ inserts elements from range.

@8@ inserts elements from initializer list.

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

@7,8@ (none)

Exceptions
@1-6,9,10@ If an exception is thrown by any operation, the insertion has no effect.

@7,8@ No exception safety guarantee.

Complexity
@1-3,9@.

@4-6,10@ Amortized constant if the insertion happens in the position just before, otherwise.

@7,8@, where is the number of elements to insert.