WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen