动态库 · 函数

定义函数

从动态库中取出函数并设置 restype/argtypes。

调用签名(库, 名称: 'str', 返回类型: 'Any' = '整数', 参数类型: 'Iterable[Any] | None' = None)

定ZHONGWEN
PYTHON

Chinese example

中文代码示例

# 案例：定义函数
设 C库 = 动态库.系统C库()
设 绝对值 = 动态库.定义函数(C库, "abs", 返回类型="整数", 参数类型=["整数"])
打印(绝对值(-8))

可直接放进 .cs / .中py 文件运行。转换器会把中文代码交给真实 Python 解释器。

Parameters

参数说明

4 个参数

参数类型 / 传入方式说明

库可选 · 默认无

未声明位置参数或字段名=值

已加载的 DLL/so/dylib 句柄，例如动态库.系统C库() 或 DLL.加载DLL("vendor.dll")。

常见错误：漏传或对象为 None 会报 TypeError/AttributeError;先调用对应的创建函数拿到库再传入

名称可选 · 默认无

str位置参数或字段名=值

动态库导出的函数名，必须与导出符号一致，例如 add、strlen、qlib_tcp_server_init。

常见错误：漏传或函数名拼写错误会报 AttributeError;用库.全部名称() 确认可用函数

返回类型可选 · 默认 '整数'

Any位置参数或字段名=值

函数返回值 C 类型；空/void 表示没有返回值。

常见错误：C 类型名拼写错误会报 KeyError;对照类型清单() 输出确认

参数类型可选 · 默认 None

Iterable[Any] | None位置参数或字段名=值

按顺序写每个参数的 C 类型；数量和顺序必须与 DLL 导出函数签名一致。

常见错误：C 类型名拼写错误会报 KeyError;对照类型清单() 输出确认

Playbook

基础用法 · 进阶组合 · 错误排查

# 案例：定义函数
设 C库 = 动态库.系统C库()
设 绝对值 = 动态库.定义函数(C库, "abs", 返回类型="整数", 参数类型=["整数"])
打印(绝对值(-8))

# 进阶组合:加载库 + 定义函数 + 调用
设 库 = 动态库.系统C库()
设 绝对值 = 动态库.定义函数(库, "abs", 返回类型="整数", 参数类型=["整数"])
设 结果 = 绝对值(-99)
打印("绝对值:", 结果)

# 错误排查:覆盖 2 个必填参数

## 参数 1: 库
# 错误:漏传或为 None 会报 TypeError/AttributeError
# 设 结果 = 动态库.定义函数(库=None)  # AttributeError
# 修复:先建立 库 再传入
设 库 = 动态库.系统C库()
设 结果 = 动态库.定义函数(库=库)

## 参数 2: 名称
# 错误:名称拼写错误或重复会报 KeyError/ValueError
# 设 结果 = 动态库.定义函数(名称="不存在的名称")  # KeyError
# 修复:先打印可用名称列表确认
设 结果 = 动态库.定义函数(名称="abs")
打印(结果)