[#bsl-vector-00d-insert-06ba]
= xref:bsl.adoc[bsl]::xref:bsl/vector-00d.adoc[vector]::insert
:relfileprefix: ../../
:mrdocs:

Insert the elements of `values` before `position`.

== Synopsis

Declared in `<bslstl_vector.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/vector-00d/iterator.adoc[vector<VALUE_TYPE, ALLOCATOR>::iterator]
insert(
    xref:bsl/vector-00d/const_iterator.adoc[const_iterator] position,
    std::initializer_list<VALUE_TYPE> values);
----

== Description

Insert at the specified `position` in this vector each `VALUE_TYPE` object in the specified `values` initializer list, and return an iterator referring to the first newly inserted element. If an exception is thrown (other than by the copy constructor, move constructor, assignment operator, and move assignment operator of `VALUE_TYPE`), `*this` is unaffected. Throw `std::length_error` if `size() + values.size() > max_size()`. The behavior is undefined unless `position` is an iterator in the range `[begin() .. end()]` (both endpoints included). This method requires that the (template parameter) type `VALUE_TYPE` be `copy‐insertable` into this vector (see {Requirements on `VALUE_TYPE`}).

== Return Value

iterator to the first inserted element, or `position` if empty

== Parameters

[cols="1,4"]
|===
| Name| Description
| *position*
| location before which elements are inserted
| *values*
| initializer list of values to insert
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#