转换操作
本页收录标准函数分类“转换操作”下的完整 API 合同。
BCD 转整数
BCD_TO_INT
可执行
标准函数 BCD_TO_INT:把 BCD 编码值转换为 INT。
声明层
已声明验证层
已验证执行层
可执行
签名
INT BCD_TO_INT(INT value)
参数
valueINT- BCD 编码输入。
返回值
returnINT- 转换后的 INT16 数值。
行为说明
- 把 BCD 编码转换为整数。
错误与限制
INVALID_BCD:输入为负数或任一 BCD nibble 大于 9 时运行失败。
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
转换 BCD 输入。
INT value = BCD_TO_INT(bcdValue);
相关 API
暂无已核实关系。
字节转字
BYTE_TO_WORD
可执行
标准函数 BYTE_TO_WORD:把 BYTE 零扩展为 WORD。
声明层
已声明验证层
已验证执行层
可执行
签名
WORD BYTE_TO_WORD(BYTE value)
参数
valueBYTE- 待转换字节。
返回值
returnWORD- 零扩展后的 WORD 值。
行为说明
- BYTE (8-bit) 零扩展为 WORD (16-bit)。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把 BYTE 零扩展为 WORD。
WORD wide = BYTE_TO_WORD(narrow);
相关 API
暂无已核实关系。
双整数转实数
DINT_TO_REAL
可执行
标准函数 DINT_TO_REAL:把 DINT 转换为 REAL。
声明层
已声明验证层
已验证执行层
可执行
签名
REAL DINT_TO_REAL(DINT value)
参数
valueDINT- 待转换双整数。
返回值
returnREAL- REAL 语义数值。
行为说明
- 把 DINT 转换为 REAL,数值保持。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把 DINT 转换为实数。
REAL f = DINT_TO_REAL(largeValue);
相关 API
暂无已核实关系。
双字转字
DWORD_TO_WORD
可执行
标准函数 DWORD_TO_WORD:把 DWORD 截断为 WORD。
声明层
已声明验证层
已验证执行层
可执行
签名
WORD DWORD_TO_WORD(DWORD value)
参数
valueDWORD- 待转换双字。
返回值
returnWORD- 截断后的 WORD 值。
行为说明
- DWORD (32-bit) 截断为 WORD (16-bit,取低 16 位)。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把 DWORD 截断为 WORD。
WORD narrow = DWORD_TO_WORD(wide);
相关 API
暂无已核实关系。
整数转 BCD
INT_TO_BCD
可执行
标准函数 INT_TO_BCD:把 INT 转换为 BCD 编码值。
声明层
已声明验证层
已验证执行层
可执行
签名
INT INT_TO_BCD(INT value)
参数
valueINT- 待转换整数。
返回值
returnINT- BCD 编码结果。
行为说明
- 把整数编码为 BCD。
错误与限制
BCD_RANGE_ERROR:输入不在 0..99999999 时运行失败。
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把整数编码为 BCD。
INT bcd = INT_TO_BCD(value);
相关 API
暂无已核实关系。
整数转双整数
INT_TO_DINT
可执行
标准函数 INT_TO_DINT:把 INT 转换为 DINT。
声明层
已声明验证层
已验证执行层
可执行
签名
DINT INT_TO_DINT(INT value)
参数
valueINT- 待转换整数。
返回值
returnDINT- DINT 语义数值。
行为说明
- 把 INT 升宽为 DINT,数值保持。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把 INT 升宽为 DINT。
DINT wide = INT_TO_DINT(count);
相关 API
暂无已核实关系。
整数转实数
INT_TO_REAL
可执行
标准函数 INT_TO_REAL:把 INT 转换为 REAL。
声明层
已声明验证层
已验证执行层
可执行
签名
REAL INT_TO_REAL(INT value)
参数
valueINT- INT16 输入。
返回值
returnREAL- 对应的 REAL 数值。
行为说明
- 数值保持,结果为 REAL。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把 INT 计数转换为 REAL。
REAL ratio = INT_TO_REAL(count);
相关 API
暂无已核实关系。
整数转字符串
INT_TO_STR
可执行
标准函数 INT_TO_STR:把 INT 数值转换为十进制字符串。
声明层
已声明验证层
已验证执行层
可执行
签名
STRING INT_TO_STR(INT value)
参数
valueINT- 待转换整数。
返回值
returnSTRING- 十进制字符串。
行为说明
- 把 INT 转为十进制字符串。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把计数值转成字符串。
STRING text = INT_TO_STR(count);
相关 API
暂无已核实关系。
实数转双整数
REAL_TO_DINT
可执行
标准函数 REAL_TO_DINT:去除 REAL 小数部分并转换为 DINT。
声明层
已声明验证层
已验证执行层
可执行
签名
DINT REAL_TO_DINT(REAL value)
参数
valueREAL- 待转换实数。
返回值
returnDINT- 去除小数部分后的 DINT 结果。
行为说明
- 当前实现是截断,不是舍入到最近整数。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
截断实数的小数部分为 DINT。
DINT whole = REAL_TO_DINT(measured);
相关 API
暂无已核实关系。
实数截断为整数
REAL_TO_INT
可执行
标准函数 REAL_TO_INT:去除 REAL 小数部分并转换为 INT。
声明层
已声明验证层
已验证执行层
可执行
签名
INT REAL_TO_INT(REAL value)
参数
valueREAL- 待转换实数。
返回值
returnINT- 去除小数部分后的 INT16 结果。
行为说明
- 当前实现是截断,不是舍入到最近整数。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
截断实数的小数部分。
INT whole = REAL_TO_INT(measured);
相关 API
暂无已核实关系。
实数转字符串
REAL_TO_STR
可执行
标准函数 REAL_TO_STR:把 REAL 数值转换为"R"格式字符串。
声明层
已声明验证层
已验证执行层
可执行
签名
STRING REAL_TO_STR(REAL value)
参数
valueREAL- 待转换实数。
返回值
returnSTRING- "R"格式字符串。
行为说明
- 把 REAL 转为字符串。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把测量值转成字符串。
STRING text = REAL_TO_STR(measured);
相关 API
暂无已核实关系。
舍入为三十二位整数
ROUND_TO_DINT
可执行
标准函数 ROUND_TO_DINT:先中点到偶数舍入,再按 INT32 收窄的结果。
声明层
已声明验证层
已验证执行层
可执行
签名
DINT ROUND_TO_DINT(LREAL value)
参数
valueLREAL- 输入值。
返回值
returnDINT- 先中点到偶数舍入,再按 INT32 收窄的结果。
行为说明
- 先按中点到偶数舍入,再收窄为 DINT。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
舍入为三十二位整数示例。
DINT whole = ROUND_TO_DINT(measured);
相关 API
暂无已核实关系。
舍入为十六位整数
ROUND_TO_INT
可执行
标准函数 ROUND_TO_INT:先中点到偶数舍入,再按 INT16 收窄的结果。
声明层
已声明验证层
已验证执行层
可执行
签名
INT ROUND_TO_INT(LREAL value)
参数
valueLREAL- 输入值。
返回值
returnINT- 先中点到偶数舍入,再按 INT16 收窄的结果。
行为说明
- 先按中点到偶数舍入,再按 INT16 收窄;超范围回绕。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
舍入为十六位整数示例。
INT whole = ROUND_TO_INT(measured);
相关 API
暂无已核实关系。
字符串转整数
STR_TO_INT
可执行
标准函数 STR_TO_INT:把字符串解析为 INT 数值。
声明层
已声明验证层
已验证执行层
可执行
签名
INT STR_TO_INT(STRING text)
参数
textSTRING- 待解析字符串。
返回值
returnINT- 解析后的 INT 值;解析失败返回 0。
行为说明
- 解析失败返回 0。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把输入字符串解析为整数。
INT count = STR_TO_INT(inputText);
相关 API
暂无已核实关系。
字符串转实数
STR_TO_REAL
可执行
标准函数 STR_TO_REAL:把字符串解析为 REAL 数值。
声明层
已声明验证层
已验证执行层
可执行
签名
REAL STR_TO_REAL(STRING text)
参数
textSTRING- 待解析字符串。
返回值
returnREAL- 解析后的 REAL 值;解析失败返回 0.0。
行为说明
- 解析失败返回 0.0。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把输入字符串解析为实数。
REAL value = STR_TO_REAL(inputText);
相关 API
暂无已核实关系。
转换为布尔值
BOOL
可执行
标准函数 BOOL:把数值转换为布尔值。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL BOOL(INT|DINT|REAL|LREAL value)
参数
valueINT|DINT|REAL|LREAL- 待转换数值。
返回值
returnBOOL- 布尔转换结果。
行为说明
- 非零为 TRUE,零为 FALSE。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把状态数值转换为 BOOL。
BOOL active = BOOL(stateValue);
相关 API
暂无已核实关系。
转换为三十二位整数
TO_DINT
可执行
标准函数 TO_DINT:把数值转换为有符号 DINT。
声明层
已声明验证层
已验证执行层
可执行
签名
DINT TO_DINT(LREAL value)
参数
valueLREAL- 待转换数值。
返回值
returnDINT- 有符号 32 位整数结果。
行为说明
- 去除小数部分后转换为 signed INT32。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把位置值转换为 DINT。
DINT pulses = TO_DINT(position);
相关 API
暂无已核实关系。
转换为十六位整数
TO_INT
可执行
标准函数 TO_INT:把数值转换为 PLC INT;超出 INT16 范围时截断回绕。
声明层
已声明验证层
已验证执行层
可执行
签名
INT TO_INT(LREAL value)
参数
valueLREAL- 待转换数值。
返回值
returnINT- 有符号 16 位结果。
行为说明
- 先去除小数部分,再按 signed INT16 转换。
- 超出 INT16 范围时按有符号 16 位截断回绕。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把测量值转换为 INT16。
INT count = TO_INT(measured);
相关 API
暂无已核实关系。
转换为实数
TO_REAL
可执行
标准函数 TO_REAL:把数值转换为 REAL。
声明层
已声明验证层
已验证执行层
可执行
签名
REAL TO_REAL(INT|DINT|REAL|LREAL value)
参数
valueINT|DINT|REAL|LREAL- 待转换数值。
返回值
returnREAL- REAL 语义数值。
行为说明
- 把数值转换到 REAL,数值保持。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把计数值转换为 REAL。
REAL ratio = TO_REAL(count);
相关 API
暂无已核实关系。
字转字节
WORD_TO_BYTE
可执行
标准函数 WORD_TO_BYTE:把 WORD 截断为 BYTE。
声明层
已声明验证层
已验证执行层
可执行
签名
BYTE WORD_TO_BYTE(WORD value)
参数
valueWORD- 待转换字。
返回值
returnBYTE- 截断后的 BYTE 值。
行为说明
- WORD (16-bit) 截断为 BYTE (8-bit,取低 8 位)。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把 WORD 截断为 BYTE。
BYTE narrow = WORD_TO_BYTE(wide);
相关 API
暂无已核实关系。
字转双字
WORD_TO_DWORD
可执行
标准函数 WORD_TO_DWORD:把 WORD 零扩展为 DWORD。
声明层
已声明验证层
已验证执行层
可执行
签名
DWORD WORD_TO_DWORD(WORD value)
参数
valueWORD- 待转换字。
返回值
returnDWORD- 零扩展后的 DWORD 值。
行为说明
- WORD (16-bit) 零扩展为 DWORD (32-bit)。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把 WORD 零扩展为 DWORD。
DWORD wide = WORD_TO_DWORD(narrow);
相关 API
暂无已核实关系。
共享错误码
以下错误码在本分类的多个 API 条目中重复出现,统一在此说明以避免冗余。各条目的"错误与限制"小节仅列出该 API 专属的错误码。
错误码前缀对照
| 前缀 | 含义 | 示例 |
|---|---|---|
COMPILE_ | 编译参数:SCL 参数类型/范围/枚举校验 | COMPILE_ARGUMENT_ERROR |
COMPILE_ARGUMENT_ERROR
COMPILE_ 编译参数:SCL 参数类型/范围/枚举校验
出现在 21 个 API 条目中。
- 缺少必需实参或参数类型不匹配时编译失败。