CKTIS / C++
std::generator: lijeni raspon temeljen na korutini
C++23 std::generator pretvara korutinu s co_yield u premjestiv jednoprolazni raspon koji proizvodi na zahtjev.
Verzija: C++23
Sintaksa
template<class Ref, class Value = void, class Allocator = void>
class std::generator;
// A coroutine returning std::generator<T> can use:
co_yield expression;
// std::generator models std::ranges::view and std::ranges::input_range.std::generator<Ref> iz <generator> istodobno je view i ulazni raspon. Korutinska funkcija s tim povratnim tipom može koristiti co_yield; poziv stvara okvir, ali tijelo isprva ostaje suspendirano. Prvi begin() nastavlja do prve vrijednosti, a povećanje iteratora do sljedećeg co_yield ili kraja. Elemente ne treba unaprijed materijalizirati u spremniku.
Korutina squares() u primjeru računa kvadrate tek kada ih iteracija zatraži. Svaki co_yield value * value suspendira sa sljedećim rezultatom; rasponska petlja kopira 1, 4 i 9 pa ispisuje 1 4 9. Privremeni generator živi kroz cijelu petlju, a njegov destruktor uništava okvir. Rani prekid također sigurno uništava neizvršeni ostatak.
std::generator je premjestiv, nekopirljiv i modelira samo input_range: ne pretpostavljaj više prolaza niti čuvaj dobivenu referencu nakon povećanja iteratora. Drugi poziv begin() na istom generatoru ima nedefinirano ponašanje. Neuhvaćena iznimka tijela izlazi iz iteracije koja je nastavila korutinu; alokacija okvira može baciti std::bad_alloc. Objekti na koje upućuje co_yield moraju živjeti kroz suspenziju. std::ranges::elements_of lijeno spljoštava kompatibilan raspon, a allocator upravlja memorijom okvira.
Primjeri
#include <generator>
#include <iostream>
std::generator<int> squares() {
for (int value = 1; value <= 3; ++value) {
co_yield value * value;
}
}
int main() {
bool first = true;
for (int value : squares()) {
if (!first) std::cout << ' ';
std::cout << value;
first = false;
}
std::cout << '\n';
}
Rezultat
1 4 9
std::generator → 1 4 9