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