C++ vector insert() function
Example
Insert an element into a vector:
vector<string> cars = {"Volvo", "BMW", "Ford", "Mazda"};
cars.insert(cars.begin() + 2, "Toyota");
for (string car : cars) {
cout << car << "\n";
}
Definition and Usage
The insert() function inserts an element or a range of elements at a specified position in a vector.
The position is specified by an iterator. There are three ways to specify what value or values are inserted:
- Specify a value for a single element
- Specify a number of elements to insert and a single value to put in all of them
- Specify a range of elements to copy from another data structure
Syntax
One of the following:
vector.insert(iterator position, <type> value);vector.insert(iterator position, size_t amount, <type> value);vector.erase(iterator position, iterator start, iterator end);The size_t data type is a non-negative integer. <type> refers to the type of the data that the vector contains.
Parameter Values
| Parameter | Description |
|---|---|
| position | Required. An iterator pointing to the position where the elements will be inserted. |
| amount | Required. An integer specifying the number of elements to insert. |
| value | Required. The value that inserted elements will contain. |
| start | Required. An iterator pointing to the start of the range to be copied. |
| end | Required. An iterator pointing to the end of the range to be copied. Elements up to this position will be copied, but the element at this position will not be copied. |
Technical Details
| Returns: | An iterator pointing to the first inserted element. |
|---|
More Examples
Example
Insert a value multiple times:
vector<string> cars = {"Volvo", "BMW", "Ford", "Mazda"};
cars.insert(cars.begin() + 2, 3, "Toyota");
for (string car : cars) {
cout << car << "\n";
}Example
Insert a range of elements from another vector:
vector<string> cars = {"Volvo", "BMW", "Ford", "Mazda"};
vector<string> newcars = {"Toyota", "Mercedes"};
cars.insert(cars.begin() + 2, newcars.begin(), newcars.end());
for (string car : cars) {
cout << car << "\n";
}Related Pages
Read more about vectors in our Vector Tutorial.
Read more about iterators in our Iterators Tutorial.
