Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

Korutine

Korutina lahko začasno ustavi izvajanje in ga pozneje nadaljuje, pri tem pa ohrani potrebno stanje. Ključne besede co_await, co_yield in co_return sodelujejo s tipom promise in ročajem korutine; samodejno ne zaženejo niti ali razvrščevalnika opravil.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

co_await expression; co_yield expression; co_return [expression];

Korutina je funkcija, katere telo vsebuje co_await, co_yield ali co_return. Ko se začasno ustavi, ohrani stanje, potrebno za nadaljevanje. Nadzor se lahko vrne tistemu, ki jo je poklical ali nadaljeval. Če pa await_suspend() objekta awaiter vrne ročaj druge korutine, nadzor preide neposredno na to korutino. To ne pomeni samodejnega vzporednega izvajanja: korutina sama ne ustvari niti ali razvrščevalnika opravil.

co_await uporablja protokol awaiter: await_ready() preveri, ali je rezultat pripravljen, await_suspend() obravnava začasno ustavitev, await_resume() pa zagotovi rezultat. Korutina po co_await ne ostane nujno začasno ustavljena. co_yield value počaka na rezultat promise.yield_value(value), ne da bi uporabil await_transform objekta promise. Izrecno zapisani izraz co_await promise.yield_value(value) pa uporabi await_transform, če ga tip promise zagotavlja. Zamenjava lahko zato spremeni vedenje ali povzroči napako pri prevajanju. co_return konča telo korutine, namesto da bi vrednost neposredno posredoval klicatelju.

Tip promise, običajno dostopen kot promise_type povratnega tipa, med drugim določa objekt rezultata, začetno in končno začasno ustavitev, zaključek ter obravnavo izjem. <coroutine> zagotavlja std::coroutine_handle in std::suspend_always. Ročaj sam ne upravlja življenjske dobe stanja: odgovornost za njegovo uničenje mora biti izrecno določena.

V primeru je Task lastnik, ki ga ni mogoče kopirati ali premakniti. initial_suspend() odloži izvajanje telesa, final_suspend() pa ohrani stanje, da ga lahko uniči destruktor. V primeru uporabljeni std::suspend_always ne preda nadzora neposredno drugi korutini. Dve nadaljevanji izpišeta 1 in 2; tretje zaradi done() ne naredi ničesar. Nadaljevanje korutine, ki se je že končala ali ni začasno ustavljena, povzroči nedefinirano vedenje. Ko je stanje korutine uničeno, nedefinirano vedenje povzroči tudi poskus nadaljevanja prek ročaja, ki kaže na to stanje. Ponastavitev tega ročaja s prireditvijo vrednosti nullptr pa je dobro definirana. Objekti, na katere se sklicujejo reference, morajo ostati živi dovolj dolgo.

Ta zapis obravnava C++23; zastavica prevajalnika v repozitoriju ne potrjuje podpore v produkcijskem izvajalnem okolju. Priloženi dokument je razvijajoči se delovni osnutek, ne dokončna izdaja C++23. Primer je treba preveriti lokalno in ob neobravnavani izjemi namerno pokliče std::terminate().

Primeri

#include <coroutine>
#include <exception>
#include <iostream>

class Task {
public:
    struct promise_type {
        Task get_return_object() {
            return Task{std::coroutine_handle<promise_type>::from_promise(*this)};
        }
        std::suspend_always initial_suspend() noexcept { return {}; }
        std::suspend_always final_suspend() noexcept { return {}; }
        void return_void() noexcept {}
        void unhandled_exception() noexcept { std::terminate(); }
    };

    using Handle = std::coroutine_handle<promise_type>;
    explicit Task(Handle handle) noexcept : handle_(handle) {}
    Task(const Task&) = delete;
    Task& operator=(const Task&) = delete;
    ~Task() { handle_.destroy(); }

    void resume() {
        if (!handle_.done()) {
            handle_.resume();
        }
    }

private:
    Handle handle_;
};

Task steps() {
    std::cout << "1\n";
    co_await std::suspend_always{};
    std::cout << "2\n";
    co_return;
}

int main() {
    auto task = steps();
    task.resume();
    task.resume();
    task.resume();
}

Rezultat

1
2

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri