CKTIS / C++
std::back_insert_iterator — добавяне чрез изходен итератор
std::back_insert_iterator е адаптер на изходен итератор, който преобразува присвояването на стойност в извикване на push_back за контейнера. Позволява да добавяте елементи с *out++ = value, без да презаписвате съществуващите.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <iterator>
std::back_insert_iterator<Container> out(container);
*out++ = value;
// Equivalent factory:
auto out2 = std::back_inserter(container);std::back_insert_iterator<Container> от заглавния файл <iterator> е адаптер на изходен итератор. Конструкторът му приема Container& и съхранява адреса на контейнера; адаптерът не го притежава. Контейнерът трябва да остане валиден, докато адаптерът се използва, и да предоставя подходящата операция push_back.
Присвояването на стойност чрез адаптера добавя елемент: претоварването за const Container::value_type& извиква push_back(value), а претоварването за Container::value_type&& извиква push_back(std::move(value)). operator* връща самия адаптер, а не препратка към елемент. Операторите ++ нито придвижват позиция, нито добавят елементи; следователно *out++ = value добавя точно един елемент.
Този инструмент служи за записване, а не за четене или обхождане на елементи. Той добавя нови елементи, вместо да презаписва съществуващите. Функцията std::back_inserter(container) създава същия вид адаптер, без да е необходимо изрично да се посочва типът на контейнера.
В примера контейнерът първоначално съдържа 10, а две присвоявания добавят 20 и 30. Кодът е предназначен за локално компилиране с -std=c++23. Цитираните страници представят развиващия се работен проект, а не замразено издание на C++23.
Примери
#include <cstddef>
#include <iostream>
#include <iterator>
#include <vector>
int main() {
std::vector<int> values{10};
std::back_insert_iterator<std::vector<int>> out(values);
*out++ = 20;
*out++ = 30;
for (std::size_t i = 0; i < values.size(); ++i) {
if (i != 0) {
std::cout << ' ';
}
std::cout << values[i];
}
std::cout << '\n';
}
Резултат
10 20 30
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.