CKTIS / C++
std::back_insert_iterator — pridávanie pomocou výstupného iterátora
std::back_insert_iterator je adaptér výstupného iterátora, ktorý priradenie hodnoty mení na volanie push_back kontajnera. Umožňuje pridávať prvky zápisom *out++ = value bez prepisovania existujúcich prvkov.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iterator>
std::back_insert_iterator<Container> out(container);
*out++ = value;
// Equivalent factory:
auto out2 = std::back_inserter(container);std::back_insert_iterator<Container> z hlavičky <iterator> je adaptér výstupného iterátora. Jeho konštruktor prijíma Container& a ukladá adresu kontajnera; adaptér kontajner nevlastní. Kontajner musí zostať platný počas používania adaptéra a poskytovať príslušnú operáciu push_back.
Priradenie hodnoty cez adaptér pridá prvok: preťaženie pre const Container::value_type& volá push_back(value), zatiaľ čo preťaženie pre Container::value_type&& volá push_back(std::move(value)). operator* vracia samotný adaptér, nie referenciu na prvok. Operátory ++ neposúvajú žiadnu pozíciu ani nepridávajú prvky; preto *out++ = value pridá presne jeden prvok.
Tento nástroj slúži na zapisovanie, nie na čítanie alebo prechádzanie prvkov. Pridáva nové prvky namiesto prepisovania existujúcich. Funkcia std::back_inserter(container) vytvorí rovnaký typ adaptéra bez nutnosti výslovne uviesť typ kontajnera.
V príklade kontajner spočiatku obsahuje 10 a dve priradenia pridajú 20 a 30. Kód je určený na lokálne preloženie s -std=c++23. Citované stránky predstavujú priebežne sa vyvíjajúci pracovný návrh, nie nemenné vydanie C++23.
Príklady
#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';
}
Výsledok
10 20 30
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.