C++如何实现简单的协程生成器(Generator)

落墨小哥_8147

落墨小哥_8147

2026-06-11

400人浏览

原创

不能直接用 std::coroutine_handle 写生成器,因为它是无栈协程句柄,不保存局部变量、不管理栈帧,也不能自动挂起在任意表达式中间;必须手动实现 promise_type、yield_value、内存分配等完整契约。

c++如何实现简单的协程生成器(generator)

为什么不能直接用 std::coroutine_handle 写生成器

因为 C++20 的协程是「无栈协程」,std::coroutine_handle 本身不保存局部变量、不管理栈帧,也不能自动挂起在任意表达式中间——你得自己写 promise_type、处理 yield_value、定义 get_return_object,还要手动分配内存(比如用 operator new)来保活 promise 对象。很多初学者一上来就套用标准模板,结果迭代时 resume() 崩溃或 yield 值错乱,根本原因是 promise 生命周期没对齐。

generator<t></t> 最小可行实现要覆盖哪几个关键点

一个能跑通的生成器必须解决三件事:怎么产出值、怎么控制生命周期、怎么支持范围 for。核心不是协程语法,而是 promise 的行为契约:

  • yield_value(T&& v) 必须返回 suspend_always{},否则协程不会停在 co_yield
  • initial_suspend() 返回 suspend_always{},让生成器创建后不立刻执行,等第一次 ++it 才启动
  • final_suspend() 返回 suspend_always{},防止协程销毁 promise,否则迭代器解引用会读到已释放内存
  • 迭代器内部必须持有 coroutine_handle<promise_type></promise_type>,且只在 operator++ 中调用 resume(),并在 done() 为 true 时停止

示例骨架(省略内存管理细节):

template <typename t>
struct generator {
  struct promise_type {
    T current_value;
    auto get_return_object() { return generator{handle_type::from_promise(*this)}; }
    auto initial_suspend() { return std::suspend_always{}; }
    auto final_suspend() noexcept { return std::suspend_always{}; }
    auto yield_value(T&& v) { current_value = std::move(v); return std::suspend_always{}; }
    void return_void() {}
    void unhandled_exception() { std::terminate(); }
  };
  using handle_type = std::coroutine_handle<promise_type>
  // ... 迭代器定义、begin/end 等
};</promise_type></typename>

范围 for 里 co_yield 不触发或崩溃的常见原因

最常踩的坑不是语法写错,而是生成器对象被提前析构,或者协程 handle 没正确传递给迭代器:

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
  • 如果 generator 构造函数接收的是临时 handle_type,但没用 std::move 转移所有权,迭代器持有的 handle 就是悬空的
  • 忘记在 iterator::operator++ 里检查 handle.done(),导致 resume 已结束的协程,UB
  • co_yield 后没再 co_await 或 co_return,协程卡在 final_suspend,但迭代器以为还有值,继续 ++ 就崩
  • 使用 std::vector<generator>></generator> 时,generator 移动构造没正确转移 handle,旧对象析构时把 promise 删了,新对象的 handle 指向野内存

验证方法:在 promise_type 的析构函数里打日志,看它是否在迭代中途被调用。

要不要自己管理堆内存,还是用 std::optional + 栈分配

用 std::optional<promise_type></promise_type> 把 promise 放栈上听起来干净,但不行——协程挂起时,栈帧可能已退出,promise 必须长期存活。所以必须堆分配:

  • 重载 promise_type::operator new 是最可控的方式,配合 placement new 和显式 destroy()
  • 别依赖 RAII 自动释放:generator 析构时需显式调用 handle.destroy(),否则 promise 泄漏
  • 如果只是做 demo 或短生命周期生成器(比如单次 range-for),可以用 std::unique_ptr<promise_type></promise_type> 管理,但注意 move 构造/赋值必须同步转移指针和 handle

真正难的不是写出能编译的 generator,而是让它的拷贝、移动、异常安全、多线程访问(即使不并发调用)都行为确定——这些细节在标准库还没提供 std::generator 前,没人能绕过去。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2248

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

1019

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

427

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

327

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

406

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

580

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1409

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1217

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习