动态库 · 函数

调用函数

声明并立即调用动态库函数。

调用签名

(库, 名称: 'str', *参数, 返回类型: 'Any' = '整数', 参数类型: 'Iterable[Any] | None' = None, 编码: 'str' = 'utf-8')

调ZHONGWEN
PYTHON

Chinese example

中文代码示例

# 案例：调用函数
设 C库 = 动态库.系统C库()
设 结果 = 动态库.调用函数(C库, "abs", -8, 返回类型="整数", 参数类型=["整数"])
打印(结果)

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

Parameters

参数说明

6 个参数

参数类型 / 传入方式说明

库可选 · 默认无

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

已加载的动态库对象，通常来自动态库.加载动态库、动态库.系统C库或 DLL.加载DLL。

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

名称可选 · 默认无

str位置参数或字段名=值

对象在代码和设计稿里的唯一名称，后续查找、更新、删除都靠它。

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

参数可选 · 默认不传则为空

未声明可变位置参数，可连续传多个值

传给外部函数的实际参数，顺序必须与参数类型一一对应。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

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

Any只能写字段名=值

函数返回值 C 类型，例如整数、小数、字符串、指针、空。

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

参数类型可选 · 默认 None

Iterable[Any] | None只能写字段名=值

函数参数 C 类型列表，例如 ["整数", "字符串"]。

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

编码可选 · 默认 'utf-8'

str只能写字段名=值

字符串与字节互转时使用的编码，默认 utf-8。

常见错误：编码名错误会报 LookupError;常用 utf-8 / gbk / utf8mb4

Playbook

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

# 案例：调用函数
设 C库 = 动态库.系统C库()
设 结果 = 动态库.调用函数(C库, "abs", -8, 返回类型="整数", 参数类型=["整数"])
打印(结果)

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

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

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

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