CKTIS / C++
std::vector::insert — vkládání prvků do vektoru
Vložte hodnotu, více kopií, inicializační seznam nebo rozsah iterátorů před zvolenou pozici. Použijte vrácený iterátor a zjistěte, které původní iterátory zůstávají platné.
Verze: ISO C++23; implementation support may vary
Syntaxe
/* <vector>, public members of std::vector<T, Allocator> in C++23 */
constexpr iterator insert(const_iterator pos, const T& value);
constexpr iterator insert(const_iterator pos, T&& value);
constexpr iterator insert(const_iterator pos, size_type count, const T& value);
template<class InputIt>
constexpr iterator insert(const_iterator pos, InputIt first, InputIt last);
constexpr iterator insert(const_iterator pos, std::initializer_list<T> values);std::vector::insert je členská funkce z <vector>, která mění vektor v vložením prvků před pos. Parametr pos typu const_iterator musí označovat platnou pozici ve v: v.cbegin() umožňuje vložit prvky na začátek, v.cend() je přidá na konec. Funkce vrací iterator na první vložený prvek, nebo na stejnou pozici jako pos, pokud se nic nevložilo. Výsledek nedereferencujte, pokud se rovná v.end().
insert(pos, value) s const T& kopíruje jednu hodnotu, zatímco přetížení s T&& umožňuje přesun z r-hodnoty. insert(pos, count, value) vloží count kopií a insert(pos, {a, b}) vloží prvky seznamu v daném pořadí. T musí splňovat požadavky zvoleného přetížení na konstrukci a přiřazení; u typu, který lze pouze přesouvat, nepočítejte s kopírujícími přetíženími.
insert(pos, first, last) čte platný polootevřený rozsah [first, last) bez last. Běžné iterátory jiného vektoru umožňují jeho prvky zkopírovat. Použití std::make_move_iterator na obou mezích umožňuje přesun z měnitelných zdrojových prvků, pokud to typ podporuje. Nepředávejte zdrojové iterátory z cílového vektoru: chování je nedefinované i při dostatečné kapacitě. V případě potřeby rozsah nejprve zkopírujte do samostatného kontejneru. insert_range(pos, range) je jiná členská funkce z C++23; dostupnost závisí na implementaci knihovny.
Pokud nová velikost překročí původní kapacitu, realokace zneplatní všechny dosavadní iterátory, ukazatele a reference cílového vektoru včetně starého end(). Při vložení neprázdného rozsahu nebo jiných prvků bez realokace zůstanou platné jen ty před místem vložení; původní end() se zneplatní i tehdy. Použijte vrácený iterátor nebo si vyžádejte nové. S realokací je složitost lineární vzhledem k výsledné velikosti, bez ní vzhledem k součtu počtu vložených prvků a vzdálenosti od pos ke konci.
Ne každá výjimka ponechá vektor beze změny. Selhání alokace ho nezmění, ale obecná záruka neplatí pro výjimky při kopírování, přesunu nebo přiřazování prvků ani při operacích vstupních iterátorů. Při vkládání jediného prvku na konec zůstane vektor při výjimce nezměněn, pokud T pro daný vektor splňuje Cpp17CopyInsertable nebo je std::is_nothrow_move_constructible_v<T> pravda. Jinak, pokud výjimku vyvolá přesunový konstruktor typu, který nesplňuje Cpp17CopyInsertable, účinky nejsou specifikovány.
Příklady
#include <iostream>
#include <vector>
int main() {
std::vector<int> metrics{10, 40};
const std::vector<int> batch{20, 30};
const auto first = metrics.insert(metrics.cbegin() + 1,
batch.begin(), batch.end());
std::cout << "first inserted: " << *first << '\n';
std::cout << "metrics:";
for (int value : metrics) {
std::cout << ' ' << value;
}
std::cout << "\nsize: " << metrics.size() << '\n';
}Výsledek
first inserted: 20 metrics: 10 20 30 40 size: 4
`batch` je samostatný vektor. Jeho prvky se vloží před `40`; `*first` je `20` a `metrics.size()` je `4`. Výstup nezávisí na tom, zda dojde k realokaci.
Související lekce
- C++ · Lekce 14 · Pokročilá · Verze: 3