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

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-list

co_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

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

Източници