跳到主要内容

数学函数

共 26 个 API(26 个可执行)

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

绝对值​

ABS 可执行

标准函数 ABS:返回数值的绝对值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL ABS(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
输入数值。

返回值​

returnLREAL
输入数值的绝对值。

行为说明​

  • 返回输入的绝对值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

取得误差绝对值。
LREAL magnitude = ABS(error);

相关 API​

暂无已核实关系。

反余弦​

ACOS 可执行

标准函数 ACOS:计算输入值的反余弦(弧度)。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL ACOS(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
  • 约束 输入必须在 [-1, 1] 范围内。
余弦值。

返回值​

returnLREAL
弧度结果。

行为说明​

  • 返回 [0, π] 范围内的弧度值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算余弦值对应的角度。
LREAL angle = ACOS(ratio);

相关 API​

暂无已核实关系。

反正弦​

ASIN 可执行

标准函数 ASIN:计算输入值的反正弦(弧度)。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL ASIN(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
  • 约束 输入必须在 [-1, 1] 范围内。
正弦值。

返回值​

returnLREAL
弧度结果。

行为说明​

  • 返回 [-π/2, π/2] 范围内的弧度值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算比例对应的角度。
LREAL angle = ASIN(ratio);

相关 API​

暂无已核实关系。

反正切​

ATAN 可执行

标准函数 ATAN:计算输入值的反正切(弧度)。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL ATAN(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
正切值。

返回值​

returnLREAL
弧度结果。

行为说明​

  • 返回 [-π/2, π/2] 范围内的弧度值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算斜率对应的角度。
LREAL angle = ATAN(slope);

相关 API​

暂无已核实关系。

双参数反正切​

ATAN2 可执行

标准函数 ATAN2:按两个输入的符号计算象限正确的反正切。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL ATAN2(LREAL y, LREAL x)

参数​

yLREAL
  • 输入
  • 必填
纵向分量。
xLREAL
  • 输入
  • 必填
横向分量。

返回值​

returnLREAL
象限正确的弧度角。

行为说明​

  • 参数顺序为 y、x。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

由平面分量计算方向角。
LREAL angleRad = ATAN2(deltaY, deltaX);

相关 API​

暂无已核实关系。

向上取整​

CEIL 可执行

标准函数 CEIL:返回不小于输入值的最小整数值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL CEIL(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
输入数值。

返回值​

returnLREAL
向上取整结果。

行为说明​

  • 向正无穷方向取整。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

向上取整到最近整数。
LREAL result = CEIL(measured);

相关 API​

暂无已核实关系。

溢出检测加法​

CHECKED_ADD 可执行

标准函数 CHECKED_ADD:执行加法并在溢出时抛诊断。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

DINT CHECKED_ADD(DINT a, DINT b)

参数​

aDINT
  • 输入
  • 必填
第一个加数。
bDINT
  • 输入
  • 必填
第二个加数。

返回值​

returnDINT
未溢出时的 DINT 结果。

行为说明​

  • 溢出时报错,不静默回绕。
  • 与普通加法的回绕语义区分。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、ARITHMETIC_OVERFLOW。

示例​

安全加法,溢出将报错。
DINT sum = CHECKED_ADD(count, increment);

相关 API​

暂无已核实关系。

溢出检测乘法​

CHECKED_MUL 可执行

标准函数 CHECKED_MUL:执行乘法并在溢出时抛诊断。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

DINT CHECKED_MUL(DINT a, DINT b)

参数​

aDINT
  • 输入
  • 必填
第一个乘数。
bDINT
  • 输入
  • 必填
第二个乘数。

返回值​

returnDINT
未溢出时的 DINT 结果。

行为说明​

  • 溢出时报错,不静默回绕。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、ARITHMETIC_OVERFLOW。

示例​

安全乘法,溢出将报错。
DINT product = CHECKED_MUL(quantity, price);

相关 API​

暂无已核实关系。

溢出检测减法​

CHECKED_SUB 可执行

标准函数 CHECKED_SUB:执行减法并在溢出时抛诊断。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

DINT CHECKED_SUB(DINT a, DINT b)

参数​

aDINT
  • 输入
  • 必填
被减数。
bDINT
  • 输入
  • 必填
减数。

返回值​

returnDINT
未溢出时的 DINT 结果。

行为说明​

  • 溢出时报错,不静默回绕。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、ARITHMETIC_OVERFLOW。

示例​

安全减法,溢出将报错。
DINT diff = CHECKED_SUB(total, deduction);

相关 API​

暂无已核实关系。

区间钳制​

CLAMP 可执行

标准函数 CLAMP:限制在 [lower, upper] 内的值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL CLAMP(LREAL value, LREAL lower, LREAL upper)

参数​

valueLREAL
  • 输入
  • 必填
输入值。
lowerLREAL
  • 输入
  • 必填
下限。
upperLREAL
  • 输入
  • 必填
上限。

返回值​

returnLREAL
限制在 [lower, upper] 内的值。

行为说明​

  • CLAMP(value, lower, upper) 把值限制在 [lower, upper] 内;参数顺序与 LIMIT 不同。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、INVALID_RANGE。

示例​

区间钳制示例。
LREAL safe = CLAMP(command, 0.0, 100.0);

相关 API​

暂无已核实关系。

余弦​

COS 可执行

标准函数 COS:计算输入弧度的余弦值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL COS(LREAL radians)

参数​

radiansLREAL
  • 输入
  • 必填
  • 单位 rad
弧度输入。

返回值​

returnLREAL
余弦值。

行为说明​

  • 参数单位为弧度。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算角度的余弦。
LREAL x = COS(angleRad);

相关 API​

暂无已核实关系。

递减一​

DEC 可执行

标准函数 DEC:返回输入减一后的值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL DEC(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
输入值。

返回值​

returnLREAL
输入值减一。

行为说明​

  • 返回输入减一。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

剩余数减一。
remaining = DEC(remaining);

相关 API​

暂无已核实关系。

自然指数​

EXP 可执行

标准函数 EXP:计算 e 的指定次幂。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL EXP(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
指数。

返回值​

returnLREAL
e^value。

行为说明​

  • 参数单位为自然对数底 e。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算指数增长。
LREAL growth = EXP(rate);

相关 API​

暂无已核实关系。

向下取整​

FLOOR 可执行

标准函数 FLOOR:返回不大于输入值的最大整数值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL FLOOR(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
输入数值。

返回值​

returnLREAL
向下取整结果。

行为说明​

  • 向负无穷方向取整。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

向下取整到最近整数。
LREAL result = FLOOR(measured);

相关 API​

暂无已核实关系。

递增一​

INC 可执行

标准函数 INC:返回输入加一后的值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL INC(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
输入值。

返回值​

returnLREAL
输入值加一。

行为说明​

  • 返回输入加一。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计数值加一。
count = INC(count);

相关 API​

暂无已核实关系。

线性插值​

LERP 可执行

标准函数 LERP:在输入域和输出域之间执行线性插值/映射。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL LERP(LREAL x, LREAL inLo, LREAL inHi, LREAL outLo, LREAL outHi)

参数​

xLREAL
  • 输入
  • 必填
输入值。
inLoLREAL
  • 输入
  • 必填
输入域下限。
inHiLREAL
  • 输入
  • 必填
输入域上限。
outLoLREAL
  • 输入
  • 必填
输出域下限。
outHiLREAL
  • 输入
  • 必填
输出域上限。

返回值​

returnLREAL
映射后输出值。

行为说明​

  • LERP(x, lo, hi, outLo, outHi) = outLo + (x-lo)*(outHi-outLo)/(hi-lo)。
  • 命名对齐工业通用 LERP,与 SCALE 数学等价。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

把 4-20mA 信号映射到 0-100%。
LREAL scaled = LERP(raw, 4.0, 20.0, 0.0, 100.0);

相关 API​

暂无已核实关系。

区间限幅​

LIMIT 可执行

标准函数 LIMIT:把 value 限制在 lower 与 upper 之间。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL LIMIT(LREAL lower, LREAL value, LREAL upper)

参数​

lowerLREAL
  • 输入
  • 必填
下界。
valueLREAL
  • 输入
  • 必填
待限幅值。
upperLREAL
  • 输入
  • 必填
上界。

返回值​

returnLREAL
限制到给定区间后的值。

行为说明​

  • 值低于 lower 时返回 lower,高于 upper 时返回 upper,否则原样返回。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、INVALID_RANGE。

示例​

把输出限制在 0 到 100。
LREAL output = LIMIT(0.0, request, 100.0);

相关 API​

暂无已核实关系。

自然对数​

LN 可执行

标准函数 LN:计算输入的自然对数(以 e 为底)。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL LN(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
  • 约束 输入必须为正数。
输入数值。

返回值​

returnLREAL
自然对数结果。

行为说明​

  • LN(0) 或负数将产生 NaN 或运行诊断。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算比值的自然对数。
LREAL logVal = LN(ratio);

相关 API​

暂无已核实关系。

较大值​

MAX 可执行

标准函数 MAX:返回两个输入值中的较大值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL MAX(LREAL a, LREAL b)

参数​

aLREAL
  • 输入
  • 必填
第一个输入。
bLREAL
  • 输入
  • 必填
第二个输入。

返回值​

returnLREAL
较大值。

行为说明​

  • 两值相等时返回该值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

确保速度不低于最小速度。
LREAL high = MAX(speed, minSpeed);

相关 API​

暂无已核实关系。

较小值​

MIN 可执行

标准函数 MIN:返回两个输入中的较小值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL MIN(LREAL left, LREAL right)

参数​

leftLREAL
  • 输入
  • 必填
第一个值。
rightLREAL
  • 输入
  • 必填
第二个值。

返回值​

returnLREAL
两个值中的较小者。

行为说明​

  • 返回两个值中的较小者。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

限制请求值的上界。
LREAL limited = MIN(requested, maximum);

相关 API​

暂无已核实关系。

幂运算​

POW 可执行

标准函数 POW:计算 baseValue 的 exponent 次幂。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL POW(LREAL baseValue, LREAL exponent)

参数​

baseValueLREAL
  • 输入
  • 必填
底数。
exponentLREAL
  • 输入
  • 必填
指数。

返回值​

returnLREAL
幂运算结果。

行为说明​

  • 计算底数的指数次幂。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算平方。
LREAL square = POW(value, 2.0);

相关 API​

暂无已核实关系。

舍入到最近偶数​

ROUND 可执行

标准函数 ROUND:按中点到偶数规则舍入后的值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL ROUND(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
输入值。

返回值​

returnLREAL
按中点到偶数规则舍入后的值。

行为说明​

  • 中点按到偶数规则舍入。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

舍入到最近偶数示例。
LREAL whole = ROUND(measured);

相关 API​

暂无已核实关系。

正弦​

SIN 可执行

标准函数 SIN:计算输入弧度的正弦值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL SIN(LREAL radians)

参数​

radiansLREAL
  • 输入
  • 必填
  • 单位 rad
弧度输入。

返回值​

returnLREAL
正弦值。

行为说明​

  • 参数单位为弧度。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算角度的正弦。
LREAL y = SIN(angleRad);

相关 API​

暂无已核实关系。

平方根​

SQRT 可执行

标准函数 SQRT:计算非负输入的平方根。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL SQRT(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
  • 约束 适用于非负输入。
被开方数。

返回值​

returnLREAL
输入的平方根。

行为说明​

  • SQRT 适用于非负输入。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算二维距离。
LREAL distance = SQRT(dx * dx + dy * dy);

相关 API​

暂无已核实关系。

正切​

TAN 可执行

标准函数 TAN:计算输入弧度的正切值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL TAN(LREAL radians)

参数​

radiansLREAL
  • 输入
  • 必填
  • 单位 rad
弧度输入。

返回值​

returnLREAL
正切值。

行为说明​

  • 参数单位为弧度;π/2 附近趋近无穷。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

计算角度的正切。
LREAL slope = TAN(angleRad);

相关 API​

暂无已核实关系。

向零截断​

TRUNC 可执行

标准函数 TRUNC:去除小数部分后的值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL TRUNC(LREAL value)

参数​

valueLREAL
  • 输入
  • 必填
输入值。

返回值​

returnLREAL
去除小数部分后的值。

行为说明​

  • 向零截断;TRUNC(-3.9) 返回 -3。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

向零截断示例。
LREAL whole = TRUNC(measured);

相关 API​

暂无已核实关系。


共享错误码​

以下错误码在本分类的多个 API 条目中重复出现,统一在此说明以避免冗余。各条目的"错误与限制"小节仅列出该 API 专属的错误码。

错误码前缀对照​

前缀含义示例
ARITHMETIC_算术运算ARITHMETIC_OVERFLOW
COMPILE_编译参数:SCL 参数类型/范围/枚举校验COMPILE_ARGUMENT_ERROR

ARITHMETIC_OVERFLOW​

ARITHMETIC_ 算术运算

出现在 3 个 API 条目中。

  • 结果超出 DINT 范围或为 NaN/Infinity 时运行失败。

COMPILE_ARGUMENT_ERROR​

COMPILE_ 编译参数:SCL 参数类型/范围/枚举校验

出现在 26 个 API 条目中。

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

INVALID_RANGE​

出现在 2 个 API 条目中。

  • 下限大于上限时运行失败。