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

CKTIS / C++

co_await — čakanje v korutini

Izraz co_await uporablja protokol awaiter, da korutino po potrebi začasno ustavi in nato pridobi rezultat. Sam ne zažene niti niti ne zagotavlja razporejanja; za nadaljevanje mora poskrbeti uporabljena implementacija.

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

Sintaksa

co_await cast-expression

co_await expression označuje možno točko zaustavitve korutine, ne blokirajočega čakanja niti. Če tak izraz vključimo v telo funkcije, ta postane korutina. Tip objekta promise se določi prek std::coroutine_traits, ki mora zagotavljati ustrezen promise_type za vrnjeni tip in tipe parametrov korutine (vključno z objektnim parametrom pri nestatični članski funkciji). Ni nujno, da ima vrnjeni tip svoj gnezdeni promise_type. Operator sam ne ustvari niti niti razporejevalnika.

Če pri izrecnem co_await iskanje imena await_transform v tipu objekta promise najde deklaracijo, je awaitable rezultat klica await_transform na tem objektu z operandom kot argumentom. Sicer je awaitable prvotni operand. Če se pri izbiri preobremenitve za awaitable izbere operator co_await, se rezultat klica uporabi kot awaiter. Sam awaitable se po morebitni pretvorbi uporabi kot awaiter le, če je množica kandidatov za operator co_await prazna. Če množica ni prazna, vendar ne vsebuje nobene uporabne funkcije, je izraz co_await neveljaven. Awaiter zagotavlja await_ready(), await_suspend(h) in await_resume(). Izraz ima tip in kategorijo vrednosti rezultata funkcije await_resume().

Rezultat await_ready() se kontekstno pretvori v bool. Če pretvorba da vrednost true, se korutina ne zaustavi. To velja tudi, če je rezultat objekt razrednega tipa, katerega explicit operator bool() vrne true. Če pretvorba da vrednost false, se korutina zaustavi in pokliče se await_suspend(h). Če ima await_suspend vrnjeni tip void, vrnitev iz klica sama po sebi ne sproži nadaljevanja korutine prek mehanizma co_await. Funkcija await_suspend pa lahko sama nadaljuje izvajanje korutine ali poskrbi, da ga nadaljuje druga nit, tudi še pred vrnitvijo iz klica. Rezultat tipa bool z vrednostjo false takoj nadaljuje izvajanje korutine. Če await_suspend vrne ročaj korutine (std::coroutine_handle), se izvajanje prenese na korutino, ki jo ta ročaj označuje. await_resume() zagotovi rezultat, ko se izvajanje nadaljuje.

Primer uporablja std::suspend_always: run() izpiše start in prepusti nadzor; resume() ji omogoči izpis resumed. final_suspend() pusti okvir zaustavljen, da ga lahko sprosti destruktor Task. Korutine nikoli ne nadaljujte na njeni končni točki zaustavitve; objekti, uporabljeni po nadaljevanju, morajo še vedno obstajati.

Ta vnos obravnava C++23; navedeno spletno mesto objavlja razvijajoči se osnutek, ne nespremenjenega besedila C++23. Združljivost s produkcijskim izvajalnim okoljem ni potrjena.

Primeri

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

struct Task {
    struct promise_type;
    using Handle = std::coroutine_handle<promise_type>;

    struct promise_type {
        Task get_return_object() {
            return Task{Handle::from_promise(*this)};
        }
        std::suspend_never initial_suspend() noexcept { return {}; }
        std::suspend_always final_suspend() noexcept { return {}; }
        void return_void() noexcept {}
        void unhandled_exception() noexcept { std::terminate(); }
    };

    Handle handle;
    explicit Task(Handle h) noexcept : handle(h) {}
    Task(const Task&) = delete;
    Task& operator=(const Task&) = delete;
    ~Task() { handle.destroy(); }
};

Task run() {
    std::cout << "start\n";
    co_await std::suspend_always{};
    std::cout << "resumed\n";
}

int main() {
    auto task = run();
    std::cout << "caller\n";
    task.handle.resume();
}

Rezultat

start
caller
resumed

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

Viri