# 第三方交互函数

文档类型：函数事实页
是否可直接用于生成代码：是；本页函数条目均包含参数表
遇到不确定时：回到 [../index.md](../index.md)、[../../syntax/index.md](../../syntax/index.md)

这一页描述第三方库与外部程序交互能力。生成函数调用时，只按函数条目中的参数表传参。

## 模块范围

- 说明：第三方库与外部程序交互能力
- 函数事实数：7

## Python支持函数

### `pyRun(code)`

用途：执行 Python 代码片段。

参数个数：1
返回值：处理后的结果值

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明              |
| -------- | ------ | ---- | -------- | ----------------- |
| 1        | `code` | 是   | 字符串   | Python 代码字符串 |

### `pyCall(module_or_mode, function_or_module[, function_or_arg][, arg_values])`

用途：Python支持函数相关函数。

参数个数：2 到 4
返回值：处理后的结果值

| 参数位置 | 参数名               | 必填 | 接收类型             | 说明                                                                                     |
| -------- | -------------------- | ---- | -------------------- | ---------------------------------------------------------------------------------------- |
| 1        | `module_or_mode`     | 是   | 字符串/整数          | Python 模块名；也可传整数模式，例如源文档示例中的 `2`                                    |
| 2        | `function_or_module` | 是   | 字符串               | 当第 1 参数是模块名时为 Python 函数名；当第 1 参数是模式时为 Python 模块名               |
| 3        | `function_or_arg`    | 否   | 字符串/任意值        | 当第 1 参数是模块名时为传给 Python 函数的第一个参数；当第 1 参数是模式时为 Python 函数名 |
| 4        | `arg_values`         | 否   | 任意值/数组/命名参数 | 继续传给 Python 函数的位置参数、数组参数或命名参数                                       |

### `pyError()`

用途：获取最近一次 Python 调用错误信息。

参数个数：0
返回值：字符串

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | ---- |

## Html 和 URL 文本转换函数

### `textToHtml(text)`

用途：将普通文本转换为 HTML 文本；空格会转换为 `&nbsp;`。

适用环境：Windows TSL 解释器。
参数个数：1
返回值：字符串

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明             |
| -------- | ------ | ---- | -------- | ---------------- |
| 1        | `text` | 是   | 字符串   | 待转换的普通文本 |

### `textToURL(text)`

用途：将普通文本转换为 URL 编码文本。

适用环境：Windows TSL 解释器。
参数个数：1
返回值：字符串

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明             |
| -------- | ------ | ---- | -------- | ---------------- |
| 1        | `text` | 是   | 字符串   | 待转换的普通文本 |

### `htmlToText(text)`

用途：将 HTML 文本转换为普通文本；`&nbsp;` 会转换为空格。

适用环境：Windows TSL 解释器。
参数个数：1
返回值：字符串

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                                      |
| -------- | ------ | ---- | -------- | ----------------------------------------- |
| 1        | `text` | 是   | 字符串   | 待转换的 HTML 文本；`&#160;` 不按空格转换 |

### `urlToText(text)`

用途：将 URL 编码文本转换为普通文本。

适用环境：Windows TSL 解释器。
参数个数：1
返回值：字符串

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                  |
| -------- | ------ | ---- | -------- | --------------------- |
| 1        | `text` | 是   | 字符串   | 待转换的 URL 编码文本 |
