跳到主要内容

转换操作

共 21 个 API(21 个可执行)

本页收录标准函数分类“转换操作”下的完整 API 合同。

BCD 转整数​

BCD_TO_INT 可执行

标准函数 BCD_TO_INT:把 BCD 编码值转换为 INT。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 编码值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 数值转换为十进制字符串。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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"格式字符串。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 收窄的结果。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 收窄的结果。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 数值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 数值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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:把数值转换为布尔值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 范围时截断回绕。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 条目中。

  • 缺少必需实参或参数类型不匹配时编译失败。