CKTIS / C++
co_yield — подаване на стойност от корутина
Изразът co_yield предава операнда си на yield_value на обекта promise на корутината и изчаква резултата. В генератор той предоставя последователни стойности, без да прекратява функцията; дали изпълнението действително се спира, зависи от механизма за изчакване.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
co_yield assignment-expression
co_yield braced-init-listco_yield е ключова дума, която образува израз за подаване на стойност от корутина. Може да се появява само в контекст на функция, в който спирането е позволено. Операндът може да бъде израз за присвояване или списък за инициализация във фигурни скоби. Това не е обикновен return.
За операнд e и обект promise p, co_yield e е еквивалентен на co_await p.yield_value(e). Следователно типът promise трябва да предоставя подходящ yield_value, чийто резултат поддържа протокола за изчакване. Самата ключова дума не гарантира спиране: това поведение се определя от получения awaitable обект.
В примера std::generator<int> предоставя стойностите една по една. Цикълът в main възобновява корутината, която при всеки co_yield подава следващата стойност и спира изпълнението. При възобновяване изпълнението продължава след този израз. За разлика от него, co_return означава край на корутината, а не подаване на следващ елемент.
Примерът изисква компилатор и стандартна библиотека с поддръжка на C++23 и <generator>. Само флагът -std=c++23 не доказва нито наличието на тази библиотека, нито готовността на средата за изпълнение за производствена употреба. Изходният текст е развиващ се работен проект, а не замразеният текст на C++23.
Примери
#include <generator>
#include <iostream>
std::generator<int> numbers() {
co_yield 10;
co_yield 20;
}
int main() {
for (int value : numbers()) {
std::cout << value << '\n';
}
}
Резултат
10 20
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.