CKTIS / C++
std::generator: lenivý rozsah založený na korutíne
C++23 std::generator mení korutínu s co_yield na presúvateľný jednopriechodový rozsah tvoriaci prvky na požiadanie.
Verzia: C++23
Syntax
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> z <generator> je zároveň view a vstupný rozsah. Korutínová funkcia s týmto návratovým typom môže použiť co_yield; jej volanie vytvorí rámec, ale telo zostane spočiatku pozastavené. Prvé begin() pokračuje k prvej hodnote a zvýšenie iterátora k ďalšiemu co_yield alebo koncu. Prvky netreba vopred materializovať v kontajneri.
Korutína squares() v príklade počíta štvorce až na požiadanie iterácie. Každé co_yield value * value sa pozastaví s ďalším výsledkom; rozsahová slučka kopíruje 1, 4 a 9, preto vypíše 1 4 9. Dočasný generátor žije počas celej slučky a jeho deštruktor zničí rámec. Predčasné ukončenie tiež bezpečne zničí nevykonaný zvyšok.
std::generator je presúvateľný, nekopírovateľný a modeluje len input_range: nepredpokladajte viac priechodov ani nedržte vydanú referenciu po zvýšení iterátora. Druhé volanie begin() na rovnakom generátore má nedefinované správanie. Nezachytená výnimka z tela vyjde z iterácie, ktorá korutínu obnovila; alokácia rámca môže vyhodiť std::bad_alloc. Objekty odkazované cez co_yield musia prežiť pozastavenie. std::ranges::elements_of lenivo sploští kompatibilný rozsah a parameter alokátora riadi pamäť rámca.
Príklady
#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';
}
Výsledok
1 4 9
std::generator → 1 4 9