CKTIS / C++
std::generator: träger Coroutine-Bereich
C++23 std::generator macht aus einer co_yield-Coroutine einen verschiebbaren Single-Pass-Bereich mit bedarfsgerechter Erzeugung.
Version: 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> aus <generator> ist View und Input-Range. Eine Coroutine-Funktion mit diesem Rückgabetyp darf co_yield verwenden; ihr Aufruf erzeugt den Frame, lässt den Rumpf aber zunächst suspendiert. Das erste begin() setzt bis zum ersten Wert fort, und das Erhöhen des Iterators setzt bis zum nächsten co_yield oder Ende fort. Die Elemente müssen nicht vorher in einem Container materialisiert werden.
Die Coroutine squares() berechnet Quadrate erst, wenn die Iteration sie anfordert. Jedes co_yield value * value suspendiert mit dem nächsten Ergebnis; die Bereichsschleife kopiert 1, 4 und 9 und gibt 1 4 9 aus. Der temporäre Generator lebt während der gesamten Schleife, sein Destruktor zerstört den Coroutine-Frame. Auch ein früher Abbruch zerstört den nicht ausgeführten Rest sicher.
std::generator ist verschiebbar, nicht kopierbar und modelliert nur input_range: Mehrfachdurchlauf und eine Referenz über das Iterator-Inkrement hinaus sind nicht anzunehmen. Ein zweites begin() am selben Generator hat undefiniertes Verhalten. Eine unbehandelte Ausnahme des Rumpfs tritt in der Iterationsoperation auf, die fortgesetzt hat; Frame-Allokation kann std::bad_alloc werfen. Von co_yield referenzierte Objekte müssen die Suspendierung überleben. std::ranges::elements_of kann kompatible Generatoren oder Ranges träge abflachen; der Allokatorparameter steuert den Frame-Speicher.
Beispiele
#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';
}
Ergebnis
1 4 9
std::generator → 1 4 9