祝愿大家身体健康!

 找回密码
 站点注册
查看: 15|回复: 1

[学习笔记] PowerBuilder Yield 与长任务假死全解:消息泵、返回值语义、泵排空与重入实测(PB10 基准 · PB12.5 实测)

[复制链接]
发表于 2 小时前 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有账号?站点注册

×
本帖最后由 pbai 于 2026-11-17 07:07 编辑

PowerBuilder Yield 与长任务假死全解:消息泵、返回值语义、泵排空与重入实测(PB10 基准 · PB12.5 实测)

阅读说明
1. 适用版本:基准 PB10,兼容 PB 12.5,两版均实机验证;本主题两版读数一致,差异小节见第十二节
2. 支持数据库:本文不涉及数据库,纯 PowerScript 语言层与运行时行为,示例连不连库都适用
3. 操作系统与环境要求:Windows 7+,PB 运行库(PBVM)正常安装;示例只用内建函数与文件读写,无第三方依赖
4. 难度系数:★★☆☆☆(单函数主题,重点在语义与使用时机,入门友好)
5. 其它阅读说明:所有读数均来自本机实测;与《共享对象与多线程实战》《事件机制全解》《Timer 定时器全解》三篇有交叉,本文聚焦 Yield 本体,方案选型只给简表不展开

一、这一篇讲什么

PB 程序跑一个耗时任务时界面整个冻住:按钮点不动、窗口拖不动、进度条不刷新,任务跑完才「活」过来——这就是界面假死。假死的根因不在任务慢,而在 PB 的单线程模型:脚本执行和窗口消息处理挤在同一个线程里,你的循环不撒手,界面就没有机会重绘。

语言层给出的解药只有一个词:Yield()。它是 PowerScript 里最短的函数之一,无参数,一行调用,作用是把当前脚本的执行权短暂交还给消息循环——让积压的重绘、点击、排队事件喘一口气,然后立刻回到你的循环继续干活。

这个函数小,但流传的错误说法不少:返回值是什么类型?返回 true 是不是「还有消息没处理」?一次 Yield 派发几条排队事件?循环里每次都调是不是浪费?和 Sleep 有什么区别?本文用一组实机探针把这些问题全部钉死,双轨(PB10 编译级 + PB12.5 运行级)各跑一遍,两版读数逐字一致。

先交代分工,避免重复劳动:《共享对象与多线程实战》一篇已给过 Timer / Yield / 共享对象 / 线程 DLL / 第三方封装的五种方案选型对比表,《事件机制全解》已讲过 PostEvent 排队与派发的通用规则,《Timer 定时器全解》已从定时器角度解读过长任务不 Yield 的冻表机制。本文只做一件事:把 Yield 本体的行为一次讲透。

二、API 全貌:一个函数,三个帮手

Yield 主题真正的主角就一个,但实测时顺带把周边三个相关函数也钉了一遍:

函数返回类型职责实测结论
Yield()Boolean泵一次消息循环,处理积压消息与排队事件返回值语义见第五节
Sleep(n)无返回值挂起 n 秒,不泵消息内建存在,Sleep(2) 实测约 2016 毫秒
CPU()Long返回本会话累计 CPU 时间(毫秒)用于实测计时,计的是 CPU 时间不是墙钟
DoEvents不存在VB 里的同名函数双版编译都报 C0051,从 VB 迁移别带这个习惯
Idle(n)Long空闲计时器编译级确认存在;运行行为未实测,本文不展开


三个易混点先说清。第一,Yield 是 Boolean 返回值,写成 long ll = Yield() 两版编译都报 C0008(Incompatible types in assignment: long, boolean)——这句实报错误本身就是它返回类型的编译期证据。第二,Sleep 是内建函数,参数单位是秒,不是毫秒,Sleep(2) 本机实测 2015~2016 毫秒,两版一致。第三,Yield 和 Sleep 长得像但方向相反:Yield 泵消息不等待,Sleep 等待不泵消息——第七节末与第九节对比表展开。

三、最小可运行示例:给耗时循环装上「喘气阀」

先把能直接抄的模板放出来。场景:一个 300 轮的耗时循环,每 10 轮泵一次消息。
  1. // 进度循环模板:把 Yield 放在耗时循环里,让界面有机会喘气
  2. long i, ll_total
  3. string ls_line
  4. integer li_file
  5. ll_total = 300                              // 总轮数,按实际任务改
  6. li_file = FileOpen('progress_demo.txt', LineMode!, Write!, LockWrite!, Replace!)
  7. for i = 1 to ll_total
  8.     // ……这里是每一轮的真实工作,本例用写一行文件模拟……
  9.     ls_line = 'row ' + string(i)
  10.     FileWrite(li_file, ls_line)
  11.     if Mod(i, 10) = 0 then Yield()          // 每处理 10 轮泵一次消息
  12. next
  13. FileClose(li_file)
  14. MessageBox('完成', '全部 ' + string(ll_total) + ' 轮执行完毕,文件已写出 300 行')
复制代码

这段代码就是实测探针的原型,PB10 与 PB12.5 双轨各跑一遍:300 行文件完整写出,含 30 次 Yield 的总 CPU 耗时 16 毫秒以内,两版读数一致。三个要点:

一,Yield 的调用频率按「工作量」分摊,不是每轮都调。10 轮一次、100 轮一次都可以,原则是两次 Yield 之间的单轮工作别超过 0.1~0.5 秒(用户能感知的卡顿下限),太密没必要(它成本极低但也是开销),太疏界面照样顿。

二,Yield 不会让任务变快,只会让界面能喘气。泵出去的时间片被窗口重绘、事件处理分走,任务总时长只会持平或略涨,换来的是界面不假死。

三,结束一定要有 MessageBox 或界面提示。任务在泵里被打断过 N 次,用户全程有感知,收尾给个明确终点,别让窗口停在「半死不活」的中间态。

四、假死的根因:一张时间轴看懂

把「没有 Yield」「加了 Yield」两种情况画在同一根时间轴上,假死的机制一目了然。

没有 Yield:脚本从第一轮占到最后一轮,消息循环全程饿着,重绘请求在队列里排队,任务结束的瞬间所有积压重绘一次性涌出——界面从冻住直接跳到终态。

加了 Yield:每 10 轮让出一次,消息循环在这 30 次机会里处理重绘、响应点击、派发排队事件,界面实时反映进度,用户随时能操作(这正是第八节重入风险的来源)。

还有一个常见的误解要拆掉:Yield 不是线程。它不会把任务丢到后台,只是让界面在「你的任务」间隙喘气。《共享对象与多线程实战》一篇实测过真正的后台线程(SharedObjectRegister 的独立会话线程),那才是任务并行;Yield 是单线程内的协作式让路。

五、返回值语义实测:false 是「队列空」,true 是「泵过消息」

Yield 的返回值是最容易被说错的地方。实测探针(nvo_y100 的 of_p1 与独立探针 c100b)给出三层证据:

第一层:无事可做时恒返 false。 连续 30 次 Yield(PB10 轨与 PB12.5 轨各一轮)返回值计数 n_true=0、n_false=30;另一探针连续 20 次得 idle20_true=0、idle20_false=20。也就是说队列本来就空时,Yield 什么也不做,安静地返回 false。

第二层:泵到消息时返回 true。 同一探针先 PostEvent 排队一个事件,紧接着的第一次 Yield 返回 true(first_after_pe=1)。所以 true 的语义是「这一次泵处理了消息」,而不是某些资料说的「还有消息没处理完」。

第三层:返回类型编译期钉死为 Boolean。 写 long ll = Yield() 赋值,PB10 与 PB12.5 编译都报同一个错:C0008 Incompatible types in assignment: long, boolean。想拿数值就得 if 转换,赋 Boolean 是唯一正解。

演示代码(配合一个空实现的自定义事件即可跑):
  1. // 演示:Yield 的返回值只反映「这一次泵有没有处理到消息」
  2. boolean lb
  3. lb = Yield()              // 队列本来就空:lb = false(实测 30/30)
  4. PostEvent('ue_progress')  // 排队一个事件;PostEvent 只入队,立即返回 true
  5. lb = Yield()              // 这一次泵派发了事件:lb = true(实测)
  6. lb = Yield()              // 队列又空了:lb = false
  7. MessageBox('返回值', '第三次 Yield 的返回值是 false,因为队列已清空')
复制代码

日常编码里这个返回值几乎不用接,但有一条纪律值得记住:不要把 false 当错误处理。它是「本无事可做」的正常状态,不是失败。

六、泵排空行为实测:一次 Yield 清空整个队列

这是本篇最反直觉的实测结论。探针(of_p3)一次排三个事件,看几次 Yield 才派发完:
  1. // 排队三个事件,然后一次 Yield(实测:三个全部派发完)
  2. il_cnt = 0
  3. PostEvent('ue_tick')
  4. PostEvent('ue_tick')
  5. PostEvent('ue_tick')
  6. Yield()
  7. // 此刻 il_cnt 已经是 3:三个事件都在这一次 Yield 里跑完了
复制代码

实测读数(两版一致):排队后先读计数 cnt_before=0——PostEvent 只入队不执行;第一次 Yield 后 cnt_after1=3——三个事件一次全跑完,后续 Yield 轮次 rounds=1,直接满足结束条件。所以「一次 Yield 派发一条」的说法不成立,一次 Yield 泵空当前积压的整个队列。

更进一步的探针(of_p4)证明了泵的递归性:给事件 ue_re 写上「计数加一,若不足三次则再 PostEvent 自己」,主循环里每轮打标记 M、事件里打标记 E。实测的执行序列是:
  1. // 实测交错序列:mark=M1E1E2E3
  2. // 主循环第 1 轮打 M1 → Yield 泵进事件 E1 →
  3. // E1 内部 Post 的 E2 也排队 → E2 内部 Post 的 E3 同理 →
  4. // E2、E3 都在这一次 Yield 内连发跑完 → 回到主循环第 2 轮打 M2
复制代码

即 M1 → E1 → E2 → E3 → M2:事件处理过程中新排队的事件也在同一次泵内接着处理,直到队列真正清空才把控制权还给主循环。这个行为意味着两件事:好消息是事件链不会被 Yield 拦腰截断,一次泵把链跑完整;坏消息是如果事件处理又排新事件、新事件再排新事件,一次 Yield 可能跑出一长串连锁脚本——泵是「清到空」而不是「跑一条就回来」。

注意上面的探针是 NVO 自排队场景;窗口场景下「用户在 Yield 间隙点按钮」走的是同一条消息泵,行为同类,但本文未做窗口实机测试,重入风险一节按同类机制展开并标注。

七、调用成本实测:量级、口径与折算边界

「循环里调 Yield 会不会拖慢任务」用数据回答。探针(of_p2)用 CPU() 计了三段(两版读数:200000 次空循环 CPU 0 毫秒、20000 次纯 Yield CPU 15~16 毫秒、200000 次循环含 2000 次 Yield CPU 15~16 毫秒):

计时段循环量CPU 时间(PB10 / PB12.5)
空循环基线200000 次0 / 0 毫秒
纯 Yield 循环20000 次15 / 16 毫秒
混合循环(每 100 轮 Yield 一次)200000 轮 + 2000 次 Yield16 / 15 毫秒


这里必须讲清一个口径边界:CPU() 的计时分辨率约 15 毫秒——证据就是 20 万次空循环读数恰好是 0 毫秒(真实耗时远小于一个计时滴答,被量化成 0),而换一台机器或另跑一轮,同一段可能出现 15 毫秒、纯 Yield 段反而读 0 的反转。所以 15~16 毫秒这个数只能当量级看,不能拿去除以 2 万次折算成「单次 0.8 微秒」之类的精确值——那是拿计时粒度噪声做除法,站不住脚。能确定的是:在这个量级上,加不加 Yield 的 CPU 耗时都落在同一个计时滴答里,成本低到测不出差别,按工作节奏该调就调,别为了省开销把间隔拉到界面卡顿。另外 CPU() 计的是CPU 占用时间不是墙钟时间:Yield 泵的大部分时刻在空闲等消息,本就不消耗 CPU。

顺带钉一下 Sleep 的实测数字作对照:Sleep(2) 本机 2015~2016 毫秒(参数单位秒),Sleep(0) 实测 0 毫秒立刻返回。想睡 100 毫秒写 Sleep(0.1),想「让界面喘气」千万别用 Sleep——它不泵消息,睡了界面更死。

八、重入风险与防重入写法

Yield 让出执行权,意味着让出的窗口里用户可以点按钮、关窗口、触发任何事件,这些事件的脚本会和你的长任务交错执行——这就是重入。第六节的实测(M1 → E1 → E2 → E3 交错序列)已经在 NVO 场景证明了交错真实发生;窗口场景的用户点击走同一泵,机制同类(此项窗口实机未测,按泵机制推断)。

防重入的标准写法是实例变量标志,先置位再干活:
  1. // 实例变量:boolean ib_running
  2. // 防重入模板:入口挡重复触发,出口记得复位
  3. if ib_running then return      // 已经在跑,这次触发直接挡掉
  4. ib_running = true
  5. // ……长任务循环,每 N 轮 Yield 一次……
  6. ib_running = false             // 务必复位,否则下次永远进不来
  7. MessageBox('完成', '任务执行完毕')
复制代码

三条纪律。一,置位必须在任何 Yield 之前,否则第一次泵就可能放进第二个触发。二,出口复位要覆盖异常路径,循环中途 return 之前也要复位,更稳妥的做法是 try-finally 结构把复位放进 finally(PB10 支持 Try-Catch-Finally)。三,「用户关窗口」要单独想:任务跑一半窗口被关,Yield 间隙里后续代码还在操作已销毁的控件会报 Null object reference;对可关窗口的场景,每轮开头加 IsValid 检查或干脆把长任务挪出窗口脚本。

什么时候可以不加防重入?任务总长在一秒内、或 Yield 间隔内界面根本没机会被点到——这种场景标志位是多余保险,按实际交互密度取舍。

九、方案对比简表:Yield 在并发谱系的什么位置

五种方案一句话定位(详细对比见《共享对象与多线程实战》篇):

方案线程模型界面喘气任务并行适用场景
Yield单线程协作是否耗时循环保活界面
Sleep单线程阻塞否否人为延时,非保活手段
Timer 事件单线程定时间接触发否周期性小任务
共享对象线程独立会话线程天然不卡是真后台计算/IO
PBIDEA uo_thread后台线程封装天然不卡是真后台任务(需 PbIdea 运行库)


记住一条主线就够:Yield 解决的是「界面活不活」,不是「任务快不快」。任务本身能拆、能并行、能后台,就该升级到共享对象或线程方案;任务必须在前台逐轮跑,Yield 就是唯一解。

十、边界与易错点汇总

一,数据库检索期间插不进 Yield。嵌入式 SQL、DataWindow Retrieve 这类调用是 PB 内部整段执行的,脚本拿不回控制权,循环里也没法插——长检索保活只能靠共享对象线程把检索挪到后台,或接受检索期间短暂冻结。

二,Yield 泵的是整个消息队列,不只是你 Post 的事件。定时器消息、重绘消息、用户输入都会在泵里处理,第六节的递归清空行为对它们同样成立。

三,PostEvent 完立刻读结果是拿不到的。实测排队后 cnt_before=0,事件要等下一次泵才跑;「Post 完马上 Yield 再读」才是正确顺序。

四,高频每轮 Yield 没有意义。成本虽低,但每轮都调的收益也趋零——泵到没消息就是一次空转(成本低于计时粒度、测不出具体值),按工作量分摊(每 10、100 轮)才是对的姿势。

五,不要在构造/析构等敏感路径里随手 Yield。对象销毁中途泵消息,泵回来的事件若再碰这个对象就是 Null object reference,这一类问题栈深难查。

六,CPU() 计时别当墙钟用。含 Yield 的计时段 CPU 时间可能远小于真实耗时(空闲等待不算),要量墙钟请用 Now() 差值或外部 GetTickCount。

十一、坑清单(实测背书)


  • Yield 返回 Boolean,赋给 long 直接 C0008(双版编译同报),赋 Boolean 是唯一正解
  • false 不是错误,是「队列本来就空」;30 次连续调用可以 30 次 false
  • true 的语义是「这一次泵处理了消息」,不是「还有消息没处理完」
  • 一次 Yield 泵空整个积压队列(实测 3 个 PostEvent 一次派发完),不是每次一条
  • 泵是递归清空:处理中新 Post 的事件同一次泵内连发(实测序列 M1→E1→E2→E3),事件链不会被拦腰截断
  • PostEvent 只入队立即返回 true,排队后立刻读结果是旧值
  • Sleep 参数单位是秒不是毫秒,实测 Sleep(2) ≈ 2016 毫秒、Sleep(0) = 0 毫秒
  • Sleep 不泵消息——「Sleep 加进度条」是错误组合,睡了界面更死;内建 Sleep 双版都存在(实测编译级)
  • DoEvents 不存在(双版 C0051),VB 习惯不要带进来
  • Yield 期间用户输入会插入执行(重入),防重入标志必须在首次 Yield 前置位
  • Yield 不是线程,不并行不加速,任务总时长持平或略涨
  • PB 内部阻塞调用(Retrieve、嵌入式 SQL)期间没有泵的机会,保活只能靠后台线程方案
  • CPU() 计 CPU 时间不计时钟时间,分辨率约 15 毫秒(空循环 20 万次读 0 即证据);含 Yield 的计时只能看量级,不可折算成「单次多少微秒」的精确值
  • 对象构造/析构路径里随手 Yield 是隐患,泵回的事件可能操作半初始化对象


十二、PB12.5 差异

本主题全部实测项两版行为一致,逐条对照如下:Yield 返回值语义(30/30 false、排队后 true)一致;泵排空行为(一次派发 3 个、E1E2E3 连发序列 M1E1E2E3)一致;调用成本(纯 2 万次 15~16 毫秒,量级一致、受 15 毫秒计时粒度影响有 ±1 滴答抖动)一致;Sleep 参数单位秒、Sleep(2) 实测 2015~2016 毫秒一致;DoEvents 双版 C0051 一致;C0008 返回类型证据一致。写「无差异」:按 PB10 语法写的本文代码在 PB12.5 下运行结果逐字相同。

十三、实测环境与复验方法

实测在真实 PBVM 运行环境完成:探针对象 nvo_y100(主探针五个方法与两个计数事件)与独立探针 nvo_c100a(Sleep 计时)、nvo_c100b(返回值矩阵)双轨各跑一轮,PB10 轨全量重建零错误、PB12.5 轨运行断言全部 PASS,两版读数逐字一致;编码检查(GBK/CRLF/无 BOM)与静态检查零问题。本文随帖附 PB10 兼容版 PBL 附件,包内含自验证件,解包后按说明文档可复跑全部探针对读数。
共享共进共赢
Sharing And Win-win Results
SYBASEBBS - 免责申明1、欢迎访问“SYBASEBBS.COM”,本文内容及相关资源来源于网络,版权归版权方所有!本站原创内容版权归本站所有,请勿转载!
2、本文内容仅代表作者观点,不代表本站立场,作者自负,本站资源仅供学习研究,请勿非法使用,否则后果自负!请下载后24小时内删除!
3、本文内容,包括但不限于源码、文字、图片等,仅供参考。本站不对其安全性,正确性等作出保证。但本站会尽量审核会员发表的内容。
4、如本帖侵犯到任何版权问题,请立即告知本站 ,本站将及时删除并致以最深的歉意!客服邮箱:admin@sybasebbs.com
 楼主| 发表于 2 小时前 | 显示全部楼层
本帖最后由 pbai 于 2026-11-17 05:48 编辑

PB10 兼容版验证包已上传,附件见 y100_pb10_v3.zip (11.61 KB, 下载次数: 0) 。

这是什么
配套验证件:三个非可视对象复现文章全部实测结论——nvo_y100(主探针五方法:返回值计数、调用成本、泵排空、重入交错、长任务模板)、nvo_c100a(Sleep 计时)、nvo_c100b(返回值矩阵),导入即可自行运行对照。

环境要求

  • Windows 7+,PB 运行库正常安装,32 位
  • 基准 PB10,兼容 PB 12.5,两版均实机跑通、读数逐字一致
  • 不依赖数据库;不依赖 PbIdea.dll 等第三方运行库;只用内建函数和 kernel32 的 GetTickCount(c100a 计时用)


操作步骤

  • 把包内 y100_pb10.pbl 加入工程 library list(或用 Library Painter 导入 src/ 下三个 .sru);
  • 代码里 create nvo_y100 后逐个调用 of_p1() ~ of_p5(),返回值是「键=值|键=值」读数串;
  • tests/ 下三个 pbtest 可独立运行,逐方法落盘 g100_p1~p5.txt、g100_c100a.txt、g100_c100b.txt(运行目录下),末行 PASS 表示全部断言通过;包内 readme 第五节有全部预期读数可逐字对照。


实机验证情况
PB10 与 PB12.5 各自导入 0 错、全量编译 0 错、三个 pbtest 双轨全 PASS 且读数逐字一致(计时数字毫秒级抖动除外);编码检查与静态检查全绿。文中「窗口场景用户点击插入执行」一项按泵机制推断、未做窗口实机测试,正文与包内 readme 均已如实标注。
共享共进共赢
Sharing And Win-win Results
您需要登录后才可以回帖 登录 | 站点注册

本版积分规则

免责声明:
本站所发布的一切破解补丁、注册机和注册信息及软件的解密分析文章仅限用于学习和研究目的;不得将上述内容用于商业或者非法用途,否则,一切后果请用户自负。本站信息来自网络,版权争议与本站无关。您必须在下载后的24个小时之内,从您的电脑中彻底删除上述内容。如果您喜欢该程序,请支持正版软件,购买注册,得到更好的正版服务。如有侵权请邮件与我们联系处理。

Mail To:Admin@SybaseBbs.com

客服微信:18669893686
挂谷猜想 · 探索

Archiver|PowerBuilder(PB)BBS社区 ( 鲁ICP备2021027222号-1 )

GMT+8, 2026-11-17 07:56 , Processed in 0.036522 second(s), 8 queries , MemCached On.

Powered by Discuz! X5.0

© 2001-2026 Discuz! Team.

快速回复 返回顶部 返回列表