# builtin.thread 库模块帮助文档 ## thread 成员列表 # ### thread._callableSerialize # 界面线程内非窗口对象 _serialize 元方法设定为此函数,可支持跨线程调用, 绑定此元方法后，对象传入其他线程后所有成员调用都将回到界面线程执行 ### thread.add(k,v) # 对参数k指定线程共享变量名称的数值增加参数v指定的计数参数v可以使用负数执行减操作 ### thread.callWndMeta # 跨线程传输的窗口对象元表,用于支持跨线程调用 ### thread.callable() # 开启界面线程非窗口对象的多线程界面回调功能。此函数会将对象的_serialize 元方法指定为 thread._callableSerialize, 用于在界面线程内启用对象跨线程调用支持,注意启用后无法撤消, 启用此特性后,对象传入其他线程后所有成员调用都将回到界面线程执行, 参数指定 talbe 类型对象如果成功、或者对象已支持跨线程调用返回 true 失败返回null或false ### thread.createSuspended(suspended,cb) # suspended参数指定thread.create函数创建的线程是否为暂停状态如果@cb参数指定了线程函数,则执行线程函数后恢复原来的设置其他参数作为回调函数的参数,线程函数的返回值为此函数的返回值注意线程函数有独立的全局变量环境,线程引用的库应当在线程函数内 import ### thread.delay() # 参数指定延时值，单位毫秒，不可省略，导入 win 或 win.ui 库的界面线程内会执行 win.delay，否则执行 sleep 函数。调用 win.delay 并且退出消息循环返回 null ，否则总是返回 true。 ### thread.getIdByHandle() # 参数 @1 指定线程句柄，返回对应的线程 ID ### thread.init(k,v) # 如果参数k指定名称的线程共享变量为空值, 则初始化该变量值为参数v指定的值 ### thread.invoke # 创建线程但不返回线程句柄，线程句柄已自动关闭。成功返回线程 ID。 ### thread.invoke(aardio文件路径,调用参数) # 创建线程运行 *.aardio 文件，不返回线程句柄。该文件所在目录将被设定为此线程的应用程序根目录, 该目录下的"/lib/"目录将被设定为用户库目录, 在线程文件内可使用owner参数获取这里传入的首个调用参数。 ### thread.invoke(线程函数,其他调用参数) # ```aardio thread.invoke( function(){ /*创建线程但不返回线程句柄。注意线程函数有独立的全局变量环境,线程引用的库应当在线程函数内 import*/ } ) ``` ### thread.invokeAndWait(func,...) # ```aardio thread.invokeAndWait(func,...invokeAndWait( function(){ import win; /*创建工作线程执行参数 @1 指定的线程函数, 参数 @1 之后的其他可选参数会作为调用线程函数的参数。调用并等待线程函数执行完毕,然后获取此线程函数的返回值。如果线程内抛出异常，则返回值为 null, 错误信息。在界面线程等待时界面仍可响应用户操作，线程函数的返回值会返回给调用线程, 线程函数拥有独立的全局变量，并应遵守多线程调用规则*/ } ) ``` ### thread.invokeEx(线程函数,其他参数) # ```aardio thread.invokeEx( function(){ /*创建线程并等待线程执行完成,然后自动关闭线程句柄。可用于原生多线程回调函数中创建独立线程以启用 COM 接口, 注意线程函数有独立的全局变量环境,线程引用的库应当在线程函数内 import*/ } ) ``` ### thread.isVar() # 判断参数 @1 是否 thread.var 创建的线程共享变量。 ### thread.serializeForm(winform,kernelCall) # 用于在 _serialize 元方法内部返回序列化的窗体对象。窗体对象的 _serialize 元方法已默认调用此函数。显式调用此函数通常用于在线程间序列化对象传递其他窗体对象以替代自身。用法可参考 winex.loading 源码。参数 winform 必须指定一个窗体对象或者 hwnd 字段值为窗体句柄的表对象。 kernelCall 参数必须是 _serialize 元方法的回调参数。 ### thread.setAffinity(1,) # 指定线程在哪个CPU上运行,成功返回原CPU序号,失败返回0, 参数@1指定CPU,参数@2指定线程句柄省略参数@2在设置当前线程 ### thread.stillActive() # 线程是否未退出,参数为线程句柄 ### thread.var # 创建线程共享变量 - 可直接作为调用参数传入其他线程。注意 thread.var 不会自动释放，不再使用时一定要调用 release 方法释放 ### thread.var() # [返回对象:threadvarObject](#threadvarObject) ### thread.var(uniqueKeyName,value) # 可选用参数 @uniqueKeyName 指定线程共享变量唯一名称,可选在参数 @value 中指定初始化值, 如果不指定共享变量名，则自动分配共享变量名, 线程共享变量不会自动释放,调用 set 函数设为 null 可删除线程变量, 如果确认没有线程再使用该变量，可调用 relase 函数释放共享变量名, thread.var以及 thread.table 自动分配的线程共享变量名上限为 :0x3FFFFFFFFFFFFC0000000000000 个。应及时调用返回对象的 release 函数释放不需要的线程共享变量。 ### thread.wait() # 等待一个线程句柄返回可选使用第二个参数指定超时值（单位毫秒）成功返回true,超时返回false; ### thread.waitAll() # 等待一个或多个线程返回参数可以是多个线程句柄,或包含多个线程句柄的数组可选使用最后一个参数指定超时值（单位毫秒）成功返回值为真,失败返回空, 返回值2为错误类型,该值为字符串"timeout"表示超时 ### thread.waitClose() # 等待一个或多个线程返回,并释放所有线程句柄参数可以是多个线程句柄,或包含多个线程句柄的数组 ### thread.waitOne # 等待一个或多个线程其中一个返回如果在界面线程中调用这个函数，会在等待过程中响应用户输入消息。 ### thread.waitOne(...,timeout) # 等待一个或多个线程其中一个返回，参数可以是多个线程句柄，也可以用参数@1指定一个包含多个线程句柄的数组，注意线程句柄总数不能大于64个。可选使用最后一个 @timeout 参数指定超时值（单位毫秒）成功返回值为完成的句柄在数组中的索引,失败返回空, 返回值2为错误类型,该值为字符串"timeout"表示超时 ## threadvarObject 成员列表 # ### threadvarObject.add() # 增加数值, 共享变量之前必须是数值或者 null 值。可以在参数中指定负数执行减操作。 ### threadvarObject.get() # 获取值 ### threadvarObject.release() # 返回变量原来的值, 同时设为 null 并删除该变量。应及时释放不再使用的线程共享变量 ### threadvarObject.set() # 在参数 @1 中指定新的值，不使用时一定要设置值为 null 以删除该变量如果使用了共享变量名, 即使删除共享变量也不会再重复分配该变量名给新的线程变量, 除非调用 release 函数释放该变量名。