Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::generator: lijeni raspon temeljen na korutini

C++23 std::generator pretvara korutinu s co_yield u premjestiv jednoprolazni raspon koji proizvodi na zahtjev.

Verzija: C++23

Sintaksa

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> iz <generator> istodobno je view i ulazni raspon. Korutinska funkcija s tim povratnim tipom može koristiti co_yield; poziv stvara okvir, ali tijelo isprva ostaje suspendirano. Prvi begin() nastavlja do prve vrijednosti, a povećanje iteratora do sljedećeg co_yield ili kraja. Elemente ne treba unaprijed materijalizirati u spremniku.

Korutina squares() u primjeru računa kvadrate tek kada ih iteracija zatraži. Svaki co_yield value * value suspendira sa sljedećim rezultatom; rasponska petlja kopira 1, 4 i 9 pa ispisuje 1 4 9. Privremeni generator živi kroz cijelu petlju, a njegov destruktor uništava okvir. Rani prekid također sigurno uništava neizvršeni ostatak.

std::generator je premjestiv, nekopirljiv i modelira samo input_range: ne pretpostavljaj više prolaza niti čuvaj dobivenu referencu nakon povećanja iteratora. Drugi poziv begin() na istom generatoru ima nedefinirano ponašanje. Neuhvaćena iznimka tijela izlazi iz iteracije koja je nastavila korutinu; alokacija okvira može baciti std::bad_alloc. Objekti na koje upućuje co_yield moraju živjeti kroz suspenziju. std::ranges::elements_of lijeno spljoštava kompatibilan raspon, a allocator upravlja memorijom okvira.

Primjeri

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

Rezultat

1 4 9

std::generator → 1 4 9

Izvori