Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

co_await — čekanje u korutini

Izraz co_await koristi protokol awaitera kako bi po potrebi obustavio korutinu i zatim dobio rezultat. Sam ne pokreće dretvu niti osigurava raspoređivanje; za nastavak mora biti zadužena upotrijebljena implementacija.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

co_await cast-expression

co_await expression označava moguću točku obustave korutine, a ne blokirajuće čekanje dretve. Uvrštavanje takvog izraza u tijelo funkcije čini je korutinom. Tip objekta promise određuje se preko std::coroutine_traits, koji mora pružiti odgovarajući promise_type za povratni tip i tipove parametara korutine (uključujući parametar objekta kod nestatičke članske funkcije). Sam povratni tip ne mora sadržavati ugniježđeni promise_type. Sam operator ne stvara ni dretvu ni raspoređivač.

Ako se pri izričitom co_await u tipu objekta promise pronađe deklaracija await_transform, awaitable je rezultat poziva await_transform na tom objektu s operandom kao argumentom. U suprotnom je awaitable izvorni operand. Ako se razrješavanjem preopterećenja za awaitable odabere operator co_await, rezultat poziva upotrebljava se kao awaiter. Sam awaitable upotrebljava se kao awaiter, nakon eventualne transformacije, samo ako je skup kandidata za operator co_await prazan. Ako skup nije prazan, ali ne sadrži nijednu primjenjivu funkciju, izraz co_await nije valjan. Awaiter pruža await_ready(), await_suspend(h) i await_resume(). Izraz ima tip i kategoriju vrijednosti rezultata funkcije await_resume().

Rezultat poziva await_ready() kontekstualno se pretvara u bool. Ako pretvorba daje true, korutina se ne obustavlja. To vrijedi i kada je rezultat objekt klasnog tipa čiji explicit operator bool() vraća true. Ako pretvorba daje false, korutina se obustavlja i poziva se await_suspend(h). Ako await_suspend ima povratni tip void, sam povratak iz poziva ne dovodi do toga da mehanizam co_await nastavi izvođenje korutine. Međutim, await_suspend može izravno nastaviti izvođenje korutine ili omogućiti da ga nastavi druga dretva, čak i prije povratka iz poziva. Rezultat tipa bool s vrijednošću false odmah nastavlja izvođenje korutine, a vraćanje ručice korutine prenosi izvođenje na navedenu korutinu. await_resume() daje rezultat kada se izvođenje nastavi.

Primjer upotrebljava std::suspend_always: run() ispisuje start i prepušta kontrolu; resume() joj omogućuje ispis resumed. final_suspend() ostavlja okvir obustavljenim kako bi ga destruktor od Task mogao osloboditi. Nikad ne nastavljajte korutinu na njezinoj završnoj točki obustave; objekti koji se koriste nakon nastavka moraju i dalje postojati.

Ovaj se unos odnosi na C++23; navedeno web-mjesto objavljuje nacrt koji se razvija, a ne nepromjenjivi tekst C++23. Kompatibilnost s produkcijskim izvršnim okruženjem nije potvrđena.

Primjeri

#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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori