数学函数
本页收录标准函数分类“数学函数”下的完整 API 合同。
绝对值
ABS
可执行
标准函数 ABS:返回数值的绝对值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL ABS(LREAL value)
参数
valueLREAL- 输入数值。
返回值
returnLREAL- 输入数值的绝对值。
行为说明
- 返回输入的绝对值。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
取得误差绝对值。
LREAL magnitude = ABS(error);
相关 API
暂无已核实关系。
反余弦
ACOS
可执行
标准函数 ACOS:计算输入值的反余弦(弧度)。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL ACOS(LREAL value)
参数
valueLREAL- 余弦值。
返回值
returnLREAL- 弧度结果。
行为说明
- 返回 [0, π] 范围内的弧度值。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算余弦值对应的角度。
LREAL angle = ACOS(ratio);
相关 API
暂无已核实关系。
反正弦
ASIN
可执行
标准函数 ASIN:计算输入值的反正弦(弧度)。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL ASIN(LREAL value)
参数
valueLREAL- 正弦值。
返回值
returnLREAL- 弧度结果。
行为说明
- 返回 [-π/2, π/2] 范围内的弧度值。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算比例对应的角度。
LREAL angle = ASIN(ratio);
相关 API
暂无已核实关系。
反正切
ATAN
可执行
标准函数 ATAN:计算输入值的反正切(弧度)。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL ATAN(LREAL value)
参数
valueLREAL- 正切值。
返回值
returnLREAL- 弧度结果。
行为说明
- 返回 [-π/2, π/2] 范围内的弧度值。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算斜率对应的角度。
LREAL angle = ATAN(slope);
相关 API
暂无已核实关系。
双参数反正切
ATAN2
可执行
标准函数 ATAN2:按两个输入的符号计算象限正确的反正切。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL ATAN2(LREAL y, LREAL x)
参数
yLREAL- 纵向分量。
xLREAL- 横向分量。
返回值
returnLREAL- 象限正确的弧度角。
行为说明
- 参数顺序为 y、x。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
由平面分量计算方向角。
LREAL angleRad = ATAN2(deltaY, deltaX);
相关 API
暂无已核实关系。
向上取整
CEIL
可执行
标准函数 CEIL:返回不小于输入值的最小整数值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL CEIL(LREAL value)
参数
valueLREAL- 输入数值。
返回值
returnLREAL- 向上取整结果。
行为说明
- 向正无穷方向取整。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
向上取整到最近整数。
LREAL result = CEIL(measured);
相关 API
暂无已核实关系。
溢出检测加法
CHECKED_ADD
可执行
标准函数 CHECKED_ADD:执行加法并在溢出时抛诊断。
声明层
已声明验证层
已验证执行层
可执行
签名
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:执行乘法并在溢出时抛诊断。
声明层
已声明验证层
已验证执行层
可执行
签名
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:执行减法并在溢出时抛诊断。
声明层
已声明验证层
已验证执行层
可执行
签名
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] 内的值。
声明层
已声明验证层
已验证执行层
可执行
签名
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:计算输入弧度的余弦值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL COS(LREAL radians)
参数
radiansLREAL- 弧度输入。
返回值
returnLREAL- 余弦值。
行为说明
- 参数单位为弧度。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算角度的余弦。
LREAL x = COS(angleRad);
相关 API
暂无已核实关系。
递减一
DEC
可执行
标准函数 DEC:返回输入减一后的值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL DEC(LREAL value)
参数
valueLREAL- 输入值。
返回值
returnLREAL- 输入值减一。
行为说明
- 返回输入减一。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
剩余数减一。
remaining = DEC(remaining);
相关 API
暂无已核实关系。
自然指数
EXP
可执行
标准函数 EXP:计算 e 的指定次幂。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL EXP(LREAL value)
参数
valueLREAL- 指数。
返回值
returnLREAL- e^value。
行为说明
- 参数单位为自然对数底 e。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算指数增长。
LREAL growth = EXP(rate);
相关 API
暂无已核实关系。
向下取整
FLOOR
可执行
标准函数 FLOOR:返回不大于输入值的最大整数值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL FLOOR(LREAL value)
参数
valueLREAL- 输入数值。
返回值
returnLREAL- 向下取整结果。
行为说明
- 向负无穷方向取整。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
向下取整到最近整数。
LREAL result = FLOOR(measured);
相关 API
暂无已核实关系。
递增一
INC
可执行
标准函数 INC:返回输入加一后的值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL INC(LREAL value)
参数
valueLREAL- 输入值。
返回值
returnLREAL- 输入值加一。
行为说明
- 返回输入加一。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计数值加一。
count = INC(count);
相关 API
暂无已核实关系。
线性插值
LERP
可执行
标准函数 LERP:在输入域和输出域之间执行线性插值/映射。
声明层
已声明验证层
已验证执行层
可执行
签名
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 之间。
声明层
已声明验证层
已验证执行层
可执行
签名
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 为底)。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL LN(LREAL value)
参数
valueLREAL- 输入数值。
返回值
returnLREAL- 自然对数结果。
行为说明
- LN(0) 或负数将产生 NaN 或运行诊断。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算比值的自然对数。
LREAL logVal = LN(ratio);
相关 API
暂无已核实关系。
较大值
MAX
可执行
标准函数 MAX:返回两个输入值中的较大值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL MAX(LREAL a, LREAL b)
参数
aLREAL- 第一个输入。
bLREAL- 第二个输入。
返回值
returnLREAL- 较大值。
行为说明
- 两值相等时返回该值。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
确保速度不低于最小速度。
LREAL high = MAX(speed, minSpeed);
相关 API
暂无已核实关系。
较小值
MIN
可执行
标准函数 MIN:返回两个输入中的较小值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL MIN(LREAL left, LREAL right)
参数
leftLREAL- 第一个值。
rightLREAL- 第二个值。
返回值
returnLREAL- 两个值中的较小者。
行为说明
- 返回两个值中的较小者。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
限制请求值的上界。
LREAL limited = MIN(requested, maximum);
相关 API
暂无已核实关系。
幂运算
POW
可执行
标准函数 POW:计算 baseValue 的 exponent 次幂。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL POW(LREAL baseValue, LREAL exponent)
参数
baseValueLREAL- 底数。
exponentLREAL- 指数。
返回值
returnLREAL- 幂运算结果。
行为说明
- 计算底数的指数次幂。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算平方。
LREAL square = POW(value, 2.0);
相关 API
暂无已核实关系。
舍入到最近偶数
ROUND
可执行
标准函数 ROUND:按中点到偶数规则舍入后的值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL ROUND(LREAL value)
参数
valueLREAL- 输入值。
返回值
returnLREAL- 按中点到偶数规则舍入后的值。
行为说明
- 中点按到偶数规则舍入。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
舍入到最近偶数示例。
LREAL whole = ROUND(measured);
相关 API
暂无已核实关系。
正弦
SIN
可执行
标准函数 SIN:计算输入弧度的正弦值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL SIN(LREAL radians)
参数
radiansLREAL- 弧度输入。
返回值
returnLREAL- 正弦值。
行为说明
- 参数单位为弧度。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算角度的正弦。
LREAL y = SIN(angleRad);
相关 API
暂无已核实关系。
平方根
SQRT
可执行
标准函数 SQRT:计算非负输入的平方根。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL SQRT(LREAL value)
参数
valueLREAL- 被开方数。
返回值
returnLREAL- 输入的平方根。
行为说明
- SQRT 适用于非负输入。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算二维距离。
LREAL distance = SQRT(dx * dx + dy * dy);
相关 API
暂无已核实关系。
正切
TAN
可执行
标准函数 TAN:计算输入弧度的正切值。
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL TAN(LREAL radians)
参数
radiansLREAL- 弧度输入。
返回值
returnLREAL- 正切值。
行为说明
- 参数单位为弧度;π/2 附近趋近无穷。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算角度的正切。
LREAL slope = TAN(angleRad);
相关 API
暂无已核实关系。
向零截断
TRUNC
可执行
标准函数 TRUNC:去除小数部分后的值。
声明层
已声明验证层
已验证执行层
可执行
签名
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 条目中。
- 下限大于上限时运行失败。