База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::noop_coroutine — дескриптор на корутина без ефект

std::noop_coroutine() връща ненулев дескриптор на специална корутина, чието възобновяване и унищожаване нямат наблюдаеми ефекти. Това не е празен дескриптор.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

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

std::noop_coroutine() от <coroutine> е функция noexcept. Тя връща std::noop_coroutine_handle, псевдоним на std::coroutine_handle<std::noop_coroutine_promise>. Не изисква нито аргументи, нито написана от потребителя функция за корутина.

Върнатият дескриптор не е празен: преобразуването към bool дава true, address() е различен от нула, а done() дава false. Извикванията на resume(), operator() и destroy() нямат ефект; по-специално destroy() не прави този дескриптор невалиден. Тези гаранции не важат за произволни дескриптори на корутини.

Дескрипторът може да се преобразува към std::coroutine_handle<>. И след това преобразуване възобновяването и унищожаването нямат наблюдаеми ефекти. Не приемайте, че дескрипторите, получени от две отделни извиквания на std::noop_coroutine(), са равни: стандартът допуска и двата резултата от сравнението.

Примерът проверява състоянието преди и след операциите, включително след преобразуването към std::coroutine_handle<>. Той не извежда адреси и не сравнява отделни извиквания, така че очакваният изход е детерминистичен.

Примери

#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';
}

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници