Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje