CKTIS / C++
std::generator : plage paresseuse fondée sur une coroutine
En C++23, std::generator transforme une coroutine co_yield en plage déplaçable à passage unique produisant à la demande.
Version : C++23
Syntaxe
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> de <generator> est à la fois une vue et une plage d’entrée. Une fonction coroutine qui le renvoie peut employer co_yield ; son appel crée la frame mais laisse d’abord le corps suspendu. Le premier begin() reprend jusqu’à la première valeur, puis l’incrément de l’itérateur reprend jusqu’au prochain co_yield ou à la fin. Aucun conteneur ne doit matérialiser les éléments à l’avance.
Dans l’exemple, la coroutine squares() calcule les carrés seulement lorsque l’itération les demande. Chaque co_yield value * value suspend avec le résultat suivant ; la boucle de plage copie 1, 4 et 9 et affiche 1 4 9. Le générateur temporaire vit pendant toute la boucle et son destructeur détruit la frame. Une sortie anticipée détruit aussi correctement la partie non exécutée.
std::generator est déplaçable, non copiable et ne modélise que input_range : ne supposez ni plusieurs passages ni la persistance d’une référence après incrément. Appeler begin() plus d’une fois sur le même générateur est indéfini. Une exception non traitée du corps ressort de l’opération d’itération qui reprend la coroutine ; l’allocation de frame peut lancer std::bad_alloc. Les objets référencés par co_yield doivent survivre à la suspension. std::ranges::elements_of aplatit paresseusement une plage compatible et le paramètre allocateur contrôle la frame.
Exemples
#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';
}
Résultat
1 4 9
std::generator → 1 4 9