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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.