新闻详情

新闻详情

首页 / 资讯中心 / 详情

C++ 与 Lua 的协程交互:从原理到实战

发布时间:2026/11/18 0:01:34来源:尧图网络
C++ 与 Lua 的协程交互:从原理到实战
1. 引言在游戏开发与嵌入式脚本领域Lua 凭借轻量、高效、可嵌入的特性成为最受欢迎的脚本语言之一。而 C 作为高性能底层语言与 Lua 的结合早已是业界标配。当业务逻辑越来越复杂异步任务、状态机、迭代器生成等场景不断涌现时协程Coroutine便成为连接 C 与 Lua 的一座重要桥梁。本文将深入探讨 C 与 Lua 的协程交互机制从 Lua 协程的基本原理讲起逐步过渡到 C 侧如何创建、恢复、挂起协程并给出完整的可运行示例帮助读者在实际项目中游刃有余地运用这一技术。2. Lua 协程基础2.1 什么是协程协程是一种用户态轻量级线程它由程序员显式控制挂起yield与恢复resume不依赖操作系统内核调度。与线程不同协程在同一时刻只有一个在执行因此无需考虑数据竞争与锁问题。Lua 从 5.1 版本开始原生支持协程核心 API 包括coroutine.create(f)创建一个协程参数为协程主体函数。coroutine.resume(co, ...)恢复或首次启动协程可传入参数。coroutine.yield(...)挂起当前协程可向外传递返回值。coroutine.status(co)查询协程状态suspended / running / normal / dead。coroutine.wrap(f)以函数形式封装协程更简洁。2.2 一个简单的 Lua 协程示例localcocoroutine.create(function(a,b)print(协程启动参数,a,b)localxcoroutine.yield(ab)print(协程恢复收到,x)returndoneend)print(coroutine.resume(co,10,20))-- 输出协程启动参数10 20 / true 30print(coroutine.resume(co,99))-- 输出协程恢复收到99 / true done从这个例子可以看到resume首次调用时传入的参数会作为协程函数的入参协程内部yield挂起时其参数作为resume的返回值返回给调用者再次resume时传入的参数则作为yield的返回值回到协程内部。3. C 侧操作 Lua 协程3.1 环境准备本文示例基于 Lua 5.4使用官方 C API。请确保开发环境中已正确安装 Lua 开发库如 Linux 下liblua5.4-devWindows 下可从官网下载源码编译。3.2 创建与恢复协程在 C 中我们通过lua_newthread创建协程它返回一个新的线程即协程引用并压入栈顶。随后用lua_resume恢复执行。#includelua.hpp#includeiostreamintmain(){lua_State*LluaL_newstate();luaL_openlibs(L);// 加载协程脚本constchar*scriptR( local co coroutine.create(function(a) local b coroutine.yield(a * 2) return a b end) return co );luaL_dostring(L,script);// 栈顶即为协程对象lua_State*colua_tothread(L,-1);// 首次恢复传入参数 10lua_pushinteger(L,10);intstatuslua_resume(co,L,1);std::coutresume status: statusstd::endl;// LUA_OK(0)// 读取 yield 返回值20intfirstlua_tointeger(co,-1);std::coutyield value: firststd::endl;// 20// 再次恢复传入参数 5lua_pushinteger(L,5);statuslua_resume(co,L,1);std::coutresume status: statusstd::endl;// LUA_OK(0)// 读取最终返回值15intresultlua_tointeger(co,-1);std::coutfinal result: resultstd::endl;// 15lua_close(L);return0;}3.3 错误处理当协程执行出错时lua_resume返回LUA_ERRRUN错误信息保存在协程栈顶。务必在每次resume后检查返回值if(status!LUA_OK){constchar*errlua_tostring(co,-1);std::cerr协程错误: errstd::endl;lua_pop(co,1);}4. C 与 Lua 协程的双向数据传递4.1 从 C 向协程传参lua_resume的第三个参数表示传入参数的个数参数依次压入调用者的栈即主线程L中。协程内部通过...或具名参数接收。4.2 从协程向 C 返回值协程yield或return的值会留在协程自己的栈顶C 侧通过lua_tointeger、lua_tostring等函数读取。4.3 完整示例C 驱动的生成器下面实现一个经典的斐波那契生成器C 每次调用resume获取下一个值#includelua.hpp#includeiostreamintmain(){lua_State*LluaL_newstate();luaL_openlibs(L);constchar*scriptR( return coroutine.wrap(function() local a, b 0, 1 while true do coroutine.yield(a) a, b b, a b end end) );luaL_dostring(L,script);// 获取 wrap 返回的函数lua_State*colua_tothread(L,-1);for(inti0;i10;i){lua_pushinteger(L,0);// wrap 函数需要至少一个参数if(lua_resume(co,L,1)!LUA_OK){std::cerr协程错误: lua_tostring(co,-1)std::endl;break;}std::coutlua_tointeger(co,-1) ;}std::coutstd::endl;lua_close(L);return0;}5. 进阶C 函数中挂起协程5.1 问题场景有时我们希望 C 注册给 Lua 的函数内部也能触发协程挂起例如等待一个异步 IO 完成后再恢复。Lua 5.4 提供了lua_yieldk允许 C 函数主动挂起当前协程。5.2 使用 lua_yieldk// 挂起后再次恢复时的回调intafter_yield(lua_State*L,intstatus,lua_KContext ctx){lua_pushinteger(L,42);// 恢复后返回给 Lua 的值return1;}// 被 Lua 调用的 C 函数intc_wait(lua_State*L){// 挂起当前协程恢复时执行 after_yieldreturnlua_yieldk(L,0,0,after_yield);}注册该函数后Lua 侧调用c_wait()时协程会挂起C 主程序在合适的时机如异步回调完成再次resume协程将从after_yield继续执行。6. 常见陷阱与最佳实践6.1 栈空间管理每个协程默认拥有独立的栈空间Lua 5.4 默认 20KB 左右。创建大量协程时需注意内存占用可通过lua_gc或调整LUAI_MAXCSTACK控制。6.2 不要在协程间共享非线程安全资源虽然协程是单线程模型但多个协程共享同一个全局状态时仍需注意逻辑上的竞态尤其是涉及 C 侧静态变量时。6.3 区分主线程与协程lua_resume的第一个参数是协程自身第二个参数是调用者上下文。在协程内部调用lua_push*时操作的是协程自己的栈而非主线程栈切勿混淆。6.4 错误传播协程内的错误不会自动传播到主线程必须显式检查lua_resume返回值并读取错误信息。建议封装一个 RAII 风格的协程管理类统一处理创建、恢复与错误清理。7. 总结C 与 Lua 的协程交互本质上是围绕lua_newthread、lua_resume、lua_yieldk三个核心 API 展开的。理解协程的挂起与恢复模型掌握数据在 C 与 Lua 栈之间的传递方式就能在游戏逻辑、异步任务、数据流处理等场景中充分发挥两者的优势。建议读者动手运行本文示例并尝试将协程封装为 C 类逐步构建属于自己的脚本协程管理框架。
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/17 19:43:34

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/17 6:55:04

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/17 5:57:47

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/17 19:43:32

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉