CKTIS / C++
std::inserter — вмъкване чрез изходен итератор
std::inserter създава изходен итератор, който при всяко присвояване извиква insert на контейнера. Така алгоритъм като std::copy може да добавя елементи на избрана позиция, вместо да презаписва съществуващите.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <iterator>
template<class Container>
constexpr std::insert_iterator<Container>
inserter(Container& x, std::ranges::iterator_t<Container> i);
// Usage:
// auto out = std::inserter(container, position);std::inserter(x, i) от <iterator> връща std::insert_iterator<Container>. Създаването на адаптера не вмъква нищо; записването чрез него извиква insert на контейнера. Контейнерът трябва да поддържа тази операция, а i трябва да е валидна позиция за вмъкване в x.
Присвояването изпълнява еквивалента на iter = container->insert(iter, value); ++iter;; за аргумент от категорията rvalue използва std::move(value). Адаптерът запазва итератора, върнат от insert, след което го премества с една позиция напред. Ако insert добави нов елемент, запазената позиция е непосредствено след него. В контейнер с уникални ключове като std::set, ако вече има еквивалентен ключ, insert не добавя нищо и връща итератор към съществуващия елемент. Тогава запазената позиция е непосредствено след този съществуващ елемент. В последователен контейнер поредните записи запазват входния ред. Собственият operator++ на адаптера не премества позицията — това прави присвояването.
Адаптерът извиква операция за вмъкване, вместо да презаписва съществуващ елемент. std::back_inserter използва push_back, а std::front_inserter използва push_front; std::inserter използва insert с позиция. Контейнерът трябва да съществува през цялото време на използване на адаптера; независими промени не бива да правят запазената позиция невалидна.
Примерът вмъква 2 и 3 преди 4, като получава 1 2 3 4. Профилът за проверка е C++23; цитираният документ е развиващ се проект на стандарт, а не фиксирано издание на C++23. Това не удостоверява наличието на компилатор или поведението в производствена среда.
Примери
#include <algorithm>
#include <array>
#include <cstddef>
#include <iostream>
#include <iterator>
#include <vector>
int main() {
const std::array<int, 2> source{2, 3};
std::vector<int> destination{1, 4};
std::copy(source.begin(), source.end(),
std::inserter(destination, destination.begin() + 1));
for (std::size_t i = 0; i < destination.size(); ++i) {
if (i != 0) std::cout << ' ';
std::cout << destination[i];
}
std::cout << '\n';
}
Резултат
1 2 3 4
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.