# 系统相关函数 - 数据类型转换函数

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

## 数据类型转换函数

### `integer(value)`

用途：将数值转换为整数。

参数个数：1
返回值：整数

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明     |
| -------- | ------- | ---- | -------- | -------- |
| 1        | `value` | 是   | 数值     | 输入数值 |

### `int64(value)`

用途：将数值转换为 64 位整数。

参数个数：1
返回值：64 位整数

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明     |
| -------- | ------- | ---- | -------- | -------- |
| 1        | `value` | 是   | 数值     | 输入数值 |

### `real(value)`

用途：将数值转换为实数。

参数个数：1
返回值：实数

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明     |
| -------- | ------- | ---- | -------- | -------- |
| 1        | `value` | 是   | 数值     | 输入数值 |

### `string(value)`

用途：将数据转换为字符串。

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

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明     |
| -------- | ------- | ---- | -------- | -------- |
| 1        | `value` | 是   | 任意值   | 输入数据 |

### `wideString(value)`

用途：将数据转换为 Unicode 字符串。

参数个数：1
返回值：Unicode 字符串

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明     |
| -------- | ------- | ---- | -------- | -------- |
| 1        | `value` | 是   | 字符串   | 输入数据 |

### `binary(value)`

用途：将数据转换为二进制流。

参数个数：1
返回值：Binary 数据

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明     |
| -------- | ------- | ---- | -------- | -------- |
| 1        | `value` | 是   | 字符串   | 输入数据 |

### `setPrecision(value, digits)`

用途：设置数值的小数精度。

参数个数：2
返回值：按精度处理后的数值

| 参数位置 | 参数名   | 必填 | 接收类型 | 说明     |
| -------- | -------- | ---- | -------- | -------- |
| 1        | `value`  | 是   | 数值     | 输入数值 |
| 2        | `digits` | 是   | 整数     | 小数位数 |

### `toSTM(value, mode, precision[, arg4])`

用途：将数据序列化为 STM 二进制流。

参数个数：3 到 4
返回值：STM 二进制流

| 参数位置 | 参数名      | 必填 | 接收类型 | 说明                 |
| -------- | ----------- | ---- | -------- | -------------------- |
| 1        | `value`     | 是   | 数组     | 输入数据             |
| 2        | `mode`      | 是   | 整数     | 序列化模式（可选）   |
| 3        | `precision` | 是   | 整数     | 小数位数（可选）     |
| 4        | `arg4`      | 否   | 整数     | 按源文档示例顺序传入 |

### `toSTN(value, digits)`

用途：将数值格式化为 STN 字符串。

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

| 参数位置 | 参数名   | 必填 | 接收类型 | 说明             |
| -------- | -------- | ---- | -------- | ---------------- |
| 1        | `value`  | 是   | 数值     | 输入数值         |
| 2        | `digits` | 是   | 整数     | 小数位数（可选） |

### `exportCsv(data, out_text, include_index, include_header)`

用途：将数组导出为 CSV 格式字符串。

参数个数：4
返回值：是否成功（1/0）

| 参数位置 | 参数名           | 必填 | 接收类型 | 说明                      |
| -------- | ---------------- | ---- | -------- | ------------------------- |
| 1        | `data`           | 是   | 数组     | 数组数据                  |
| 2        | `out_text`       | 是   | 字符串   | 输出字符串（引用返回）    |
| 3        | `include_index`  | 是   | 整数     | 是否包含下标（可选，1/0） |
| 4        | `include_header` | 是   | 整数     | 是否包含表头（可选，1/0） |

### `importCsv(csv_text, out_data, has_header)`

用途：将 CSV 字符串解析为数组。

参数个数：3
返回值：是否成功（1/0）

| 参数位置 | 参数名       | 必填 | 接收类型 | 说明                      |
| -------- | ------------ | ---- | -------- | ------------------------- |
| 1        | `csv_text`   | 是   | 字符串   | CSV 字符串                |
| 2        | `out_data`   | 是   | 数组     | 输出数组（引用返回）      |
| 3        | `has_header` | 是   | 整数     | 是否包含表头（可选，1/0） |

### `stm(value)`

用途：解析 STM 序列化数据。

参数个数：1
返回值：解析后的数据

| 参数位置 | 参数名  | 必填 | 接收类型          | 说明     |
| -------- | ------- | ---- | ----------------- | -------- |
| 1        | `value` | 是   | 二进制数据/字符串 | STM 数据 |

### `stn(value)`

用途：解析 STN 数值字符串。

参数个数：1
返回值：数值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明       |
| -------- | ------- | ---- | -------- | ---------- |
| 1        | `value` | 是   | 字符串   | STN 字符串 |
