KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::generator: lui coroutinebereik

C++23 std::generator maakt van een co_yield-coroutine een verplaatsbaar eenmalig bereik dat elementen op aanvraag produceert.

Versie: 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> uit <generator> is zowel een view als een input range. Een coroutinefunctie met dit retourtype kan co_yield gebruiken; de aanroep maakt het frame maar laat het lichaam eerst gepauzeerd. De eerste begin() hervat tot de eerste waarde en iteratorverhoging hervat tot de volgende co_yield of voltooiing. Elementen hoeven niet vooraf in een container te worden vastgelegd.

De coroutine squares() in het voorbeeld berekent kwadraten pas wanneer iteratie ze vraagt. Elke co_yield value * value pauzeert met het volgende resultaat; de bereiklus kopieert 1, 4 en 9 en print dus 1 4 9. De tijdelijke generator leeft gedurende de volledige lus en zijn destructor vernietigt het coroutineframe. Vroegtijdig stoppen vernietigt ook het niet-uitgevoerde deel veilig.

std::generator is verplaatsbaar, niet kopieerbaar en modelleert alleen input_range: ga niet uit van meerdere passages en bewaar geen geleverde referentie na iteratorverhoging. begin() meer dan eenmaal op dezelfde generator aanroepen is ongedefinieerd gedrag. Een niet-afgevangen exceptie uit het lichaam komt uit de iteratiebewerking die hervatte; frameallocatie kan std::bad_alloc werpen. Door co_yield verwezen objecten moeten de pauze overleven. std::ranges::elements_of maakt een verenigbaar bereik lui vlak en de allocatorparameter bestuurt frameopslag.

Voorbeelden

#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';
}

Resultaat

1 4 9

std::generator → 1 4 9

Bronnen