Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

co_return — dovršetak korutine

co_return završava izvođenje tijela korutine i predaje rezultat objektu promise, umjesto da ga izravno vraća kao obični return. Korutina zatim nastavlja s final_suspend(); trajanje njezina stanja ovisi o mehanizmu upravljanja korutinom.

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

Sintaksa

co_return;
co_return expression;
co_return braced-init-list;

co_return označava dovršetak korutine. Već sama njegova prisutnost čini funkciju korutinom, čak i bez co_await ili co_yield. Objekt koji vraća poziv funkcije dolazi iz promise.get_return_object(); operand co_return ne mora biti povratnog tipa funkcije.

Za izraz tipa različitog od void ili popis inicijalizatora u vitičastim zagradama poziva se promise.return_value(...). co_return; poziva promise.return_void(). Ako je operand tipa void, najprije se izračunava izraz, a zatim se poziva return_void(). Ti pozivi moraju dati rezultat tipa void.

Kontrola zatim prelazi na final_suspend(). Dovršetak tijela ne znači automatsko uništavanje stanja korutine. U primjeru initial_suspend() omogućuje da se tijelo odmah izvrši, return_value(int) pohranjuje 42, a final_suspend() čuva stanje za pregled. Destruktor Result oslobađa ga pomoću destroy(); kopiranje vlasnika nije dopušteno.

Tijelo korutine ne smije sadržavati obični return. U C++23 dolazak do kraja tijela jednak je izvršavanju naredbe co_return; ako tip objekta promise ima član naziva return_void. Ako taj član postoji, ali implicitni poziv promise.return_void() nije valjan, program nije ispravno oblikovan. Ako tip objekta promise nema član s tim nazivom, dolazak do kraja tijela uzrokuje nedefinirano ponašanje. Ovaj se unos odnosi na C++23; navedeno web-mjesto sadrži radni nacrt koji se razvija, a ne zamrznuti tekst C++23.

Primjeri

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

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

    struct promise_type {
        int value = 0;
        Result get_return_object() {
            return Result{Handle::from_promise(*this)};
        }
        std::suspend_never initial_suspend() noexcept { return {}; }
        std::suspend_always final_suspend() noexcept { return {}; }
        void return_value(int n) noexcept { value = n; }
        void unhandled_exception() noexcept { std::terminate(); }
    };

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

    int value() const { return handle.promise().value; }
};

Result answer() {
    co_return 42;
}

int main() {
    auto result = answer();
    std::cout << result.value() << '\n';
}

Rezultat

42

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

Izvori