KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::noop_coroutine — een handle naar een coroutine zonder effect

std::noop_coroutine() geeft een niet-lege handle naar een speciale coroutine terug waarvan hervatten en vernietigen geen waarneembare effecten hebben. Het is geen lege handle.

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

Syntax

#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;

std::noop_coroutine() uit <coroutine> is een noexcept-functie. De functie geeft std::noop_coroutine_handle terug, een alias voor std::coroutine_handle<std::noop_coroutine_promise>. Er zijn geen argumenten of een zelfgeschreven coroutinefunctie nodig.

De teruggegeven handle is niet leeg: conversie naar bool levert true op, address() is niet null en done() levert false op. Aanroepen van resume(), operator() en destroy() hebben geen effect; met name maakt destroy() deze handle niet ongeldig. Deze garanties gelden niet voor willekeurige coroutinehandles.

De handle kan worden geconverteerd naar std::coroutine_handle<>. Ook na deze conversie hebben hervatten en vernietigen geen waarneembare effecten. Ga er niet van uit dat handles uit twee afzonderlijke aanroepen van std::noop_coroutine() gelijk zijn: de standaard staat beide vergelijkingsresultaten toe.

Het voorbeeld controleert de status vóór en na de bewerkingen, ook na conversie naar std::coroutine_handle<>. Het drukt geen adressen af en vergelijkt geen afzonderlijke aanroepen, zodat de verwachte uitvoer deterministisch is.

Voorbeelden

#include <coroutine>
#include <iostream>

int main() {
    auto h = std::noop_coroutine();
    std::cout << std::boolalpha;
    std::cout << "valid=" << static_cast<bool>(h)
              << " done=" << h.done() << '\n';

    h.resume();
    h();
    h.destroy();

    std::coroutine_handle<> erased = h;
    erased.resume();
    erased.destroy();

    std::cout << "after: valid=" << static_cast<bool>(h)
              << " done=" << h.done() << '\n';
}

Resultaat

valid=true done=false
after: valid=true done=false

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen