YStudio Y++

数值运算(基础支持库)

Y++ / YStudio 开发文档 · 一点滴

路径:支持库 → 基础支持库 → 数值运算。

硬约束

  1. 扁平命令:绝对值(-3),无对象前缀。
  2. 参数类型多为 通用(整数/小数均可),返回以签名为准。
  3. 除零类运算(余数 / 整商 / 整余 / 倒数)除数为 0 时通常返回 0。
  4. 三角函数默认 角度制(方式=1);要弧度传 方式=2。
  5. 位运算见 位运算。

快速开始

输出(四舍五入(3.14159, 2))
输出(取整(-3.9))
输出(随机数(1, 6))
输出(正弦(30))
输出(约等于(0.1 + 0.2, 0.3))

数值运算

本分类共 42 条。

N次方根

  • 签名:小数 N次方根(通用 数值, 通用 次数)
  • 说明:返回数值的 N 次方根。
  • 参数一│通用 数值: 被开方数。
  • 参数二│通用 次数: 根的次数,如 2 为平方根、3 为立方根。

三数中值

  • 签名:小数 三数中值(通用 数值一, 通用 数值二, 通用 数值三)
  • 说明:返回三个数的中位数。
  • 参数一│通用 数值一: 第一个数。
  • 参数二│通用 数值二: 第二个数。
  • 参数三│通用 数值三: 第三个数。

两数平均

  • 签名:小数 两数平均(通用 数值一, 通用 数值二)
  • 说明:返回两个数的算术平均值。
  • 参数一│通用 数值一: 第一个数。
  • 参数二│通用 数值二: 第二个数。

余弦

  • 签名:小数 余弦(通用 角度, [整数 方式=1])
  • 说明:返回角度的余弦值。
  • 参数一│通用 角度: 数值。
  • 参数二│[整数 方式=1]: 1=角度制,2=弧度制。

余数

  • 签名:小数 余数(通用 被除数, 通用 除数)
  • 说明:返回两数相除的余数。
  • 参数一│通用 被除数: 数值。
  • 参数二│通用 除数: 数值。

倒数

  • 签名:小数 倒数(通用 数值)
  • 说明:返回数值的倒数(1/数值)。
  • 参数一│通用 数值: 非零数值。

反余弦

  • 签名:小数 反余弦(通用 数值, [整数 方式=1])
  • 说明:返回数值的反余弦。
  • 参数一│通用 数值: -1~1 之间。
  • 参数二│[整数 方式=1]: 1=返回角度,2=返回弧度。

反正切

  • 签名:小数 反正切(通用 数值, [整数 方式=1])
  • 说明:返回数值的反正切。
  • 参数一│通用 数值: 任意数值。
  • 参数二│[整数 方式=1]: 1=返回角度,2=返回弧度。

反正弦

  • 签名:小数 反正弦(通用 数值, [整数 方式=1])
  • 说明:返回数值的反正弦。
  • 参数一│通用 数值: -1~1 之间。
  • 参数二│[整数 方式=1]: 1=返回角度,2=返回弧度。

取整

  • 签名:整数 取整(通用 数值)
  • 说明:将小数截断为整数部分。
  • 参数一│通用 数值: 整数或小数字面量/变量/表达式。

向上取整

  • 签名:整数 向上取整(通用 数值)
  • 说明:返回不小于该数的最小整数。
  • 参数一│通用 数值: 整数或小数字面量/变量。

向下取整

  • 签名:整数 向下取整(通用 数值)
  • 说明:返回不大于该数的最大整数。
  • 参数一│通用 数值: 整数或小数字面量/变量。

四舍五入

  • 签名:小数 四舍五入(通用 数值, [整数 小数位=0])
  • 说明:按指定小数位四舍五入。
  • 参数一│通用 数值: 欲处理的数。
  • 参数二│[整数 小数位=0]: 保留的小数位数。

对数

  • 签名:小数 对数(通用 数值, [整数 底数=1])
  • 说明:返回数值的对数。
  • 参数一│通用 数值: 正数。
  • 参数二│[整数 底数=1]: 1=自然对数(e),2=常用对数(10)。

小数部分

  • 签名:小数部分(通用 数值)
  • 说明:返回数值的小数部分。
  • 参数一│通用 数值: 整数或小数字面量/变量。

平方根

  • 签名:小数 平方根(通用 数值)
  • 说明:返回数值的算术平方根。
  • 参数一│通用 数值: 非负数值。

弧度转角度

  • 签名:小数 弧度转角度(通用 弧度)
  • 说明:将弧度制转换为角度制。
  • 参数一│通用 弧度: 弧度值。

整余

  • 签名:整数 整余(整数 被除数, 整数 除数)
  • 说明:返回两整数相除的余数。
  • 参数一│整数 被除数: 被除数。
  • 参数二│整数 除数: 除数。

整商

  • 签名:整数 整商(整数 被除数, 整数 除数)
  • 说明:返回两整数相除的商(向零截断)。
  • 参数一│整数 被除数: 被除数。
  • 参数二│整数 除数: 除数。

是否为偶数

  • 签名:逻辑 是否为偶数(整数 整数)
  • 说明:判断整数是否为偶数。
  • 参数一│整数 整数: 欲判断的整数。

是否为奇数

  • 签名:逻辑 是否为奇数(整数 整数)
  • 说明:判断整数是否为奇数。
  • 参数一│整数 整数: 欲判断的整数。

是否在范围

  • 签名:逻辑 是否在范围(通用 数值, 通用 最小, 通用 最大)
  • 说明:判断数值是否在闭区间内。
  • 参数一│通用 数值: 欲判断的数。
  • 参数二│通用 最小: 下限(含)。
  • 参数三│通用 最大: 上限(含)。

最大值

  • 签名:小数 最大值(通用 数值一, 通用 数值二)
  • 说明:返回两个数中较大者。
  • 参数一│通用 数值一: 第一个数。
  • 参数二│通用 数值二: 第二个数。

最大公约数

  • 签名:整数 最大公约数(整数 整数一, 整数 整数二)
  • 说明:返回两整数的最大公约数。
  • 参数一│整数 整数一: 第一个数。
  • 参数二│整数 整数二: 第二个数。

最小值

  • 签名:小数 最小值(通用 数值一, 通用 数值二)
  • 说明:返回两个数中较小者。
  • 参数一│通用 数值一: 第一个数。
  • 参数二│通用 数值二: 第二个数。

最小公倍数

  • 签名:整数 最小公倍数(整数 整数一, 整数 整数二)
  • 说明:返回两整数的最小公倍数。
  • 参数一│整数 整数一: 第一个数。
  • 参数二│整数 整数二: 第二个数。

次方

  • 签名:小数 次方(通用 底数, 通用 指数)
  • 说明:计算底数的指数次幂。
  • 参数一│通用 底数: 数值。
  • 参数二│通用 指数: 数值。

正切

  • 签名:小数 正切(通用 角度, [整数 方式=1])
  • 说明:返回角度的正切值。
  • 参数一│通用 角度: 数值。
  • 参数二│[整数 方式=1]: 1=角度制,2=弧度制。

正弦

  • 签名:小数 正弦(通用 角度, [整数 方式=1])
  • 说明:返回角度的正弦值。
  • 参数一│通用 角度: 数值。
  • 参数二│[整数 方式=1]: 1=角度制,2=弧度制。

比例

  • 签名:小数 比例(通用 部分, 通用 总数)
  • 说明:计算部分占总数的小数比例(0~1)。
  • 参数一│通用 部分: 分子。
  • 参数二│通用 总数: 分母。

比较大小

  • 签名:整数 比较大小(通用 数值一, 通用 数值二)
  • 说明:比较两数大小:大为 1,小为 -1,相等为 0。
  • 参数一│通用 数值一: 第一个数。
  • 参数二│通用 数值二: 第二个数。

百分比

  • 签名:小数 百分比(通用 部分, 通用 总数)
  • 说明:计算部分占总数的百分比。
  • 参数一│通用 部分: 分子。
  • 参数二│通用 总数: 分母。

立方根

  • 签名:小数 立方根(通用 数值)
  • 说明:返回数值的立方根。
  • 参数一│通用 数值: 整数或小数字面量/变量。

符号

  • 签名:整数 符号(通用 数值)
  • 说明:返回数值的符号:正数为 1,负数为 -1,零为 0。
  • 参数一│通用 数值: 整数或小数字面量/变量。

约等于

  • 签名:逻辑 约等于(通用 数值一, 通用 数值二, [小数 容差=0.000001])
  • 说明:判断两数是否在容差范围内近似相等。
  • 参数一│通用 数值一: 第一个数。
  • 参数二│通用 数值二: 第二个数。
  • 参数三│[小数 容差=0.000001]: 允许误差。

线性插值

  • 签名:小数 线性插值(通用 起点, 通用 终点, 通用 比例)
  • 说明:在起点与终点之间按比例线性插值。
  • 参数一│通用 起点: 起始值。
  • 参数二│通用 终点: 结束值。
  • 参数三│通用 比例: 0~1 之间,0 为起点,1 为终点。

绝对值

  • 签名:小数 绝对值(通用 数值)
  • 说明:返回数值的非负值。
  • 参数一│通用 数值: 整数或小数字面量/变量/表达式。

角度转弧度

  • 签名:小数 角度转弧度(通用 角度)
  • 说明:将角度制转换为弧度制。
  • 参数一│通用 角度: 角度值。

阶乘

  • 签名:整数 阶乘(整数 n)
  • 说明:返回非负整数的阶乘。
  • 参数一│整数 n: 0~20,超出按 20 计算。

限制范围

  • 签名:小数 限制范围(通用 数值, 通用 最小, 通用 最大)
  • 说明:将数值限制在指定区间内。
  • 参数一│通用 数值: 欲处理的数。
  • 参数二│通用 最小: 下限。
  • 参数三│通用 最大: 上限。

随机小数

  • 签名:小数 随机小数([小数 最小=0], [小数 最大=1])
  • 说明:返回指定范围内的随机小数。
  • 参数一│[小数 最小=0]: 仅传一个参数时表示 0~最大。
  • 参数二│[小数 最大=1]: 随机上限。

随机数

  • 签名:整数 随机数([整数 最小=0], [整数 最大=32767])
  • 说明:返回指定范围内的随机整数。
  • 参数一│[整数 最小=0]: 仅传一个参数时表示 1~最大;两参数时为本项。
  • 参数二│[整数 最大=32767]: 随机上限(含)。

易错对照

错误 正确
正弦默认当弧度 默认角度;弧度传方式=2
除零期望抛错 通常返回 0
位运算找本页 见 basic-bit

相关

位运算 · 类型转换 · 性能计时