std.math.numeric
功能介绍
math.numeric 包对基础类型可表达范围之外提供扩展能力。
例如：
- 支持大整数(BigInt)；
- 支持高精度十进制数(Decimal)类型；
- 提供常见的数学运算能力包括高精度运算规则。
API 列表
函数
| 函数名 | 功能 |
|---|---|
| abs(BigInt) | 求一个 BigInt 的绝对值。 |
| abs(Decimal) | 求一个 Decimal 的绝对值。 |
| countOne(BigInt) (deprecated) | 计算并返回入参 BigInt 的二进制补码中 1 的个数。 |
| countOnes(BigInt) | 计算并返回入参 BigInt 的二进制补码中 1 的个数。 |
| gcd(BigInt, BigInt) | 求两个 BigInt 的最大公约数。总是返回非负数（相当于绝对值的最大公约数）。 |
| lcm(BigInt, BigInt) | 求两个 BigInt 的最小公倍数。除了入参有 0 时返回 0 外，总是返回正数（相当于绝对值的最小公倍数）。 |
| round(Decimal, RoundingMode) | 计算 Decimal 的舍入值，根据舍入方式向邻近的整数舍入。 |
| sqrt(BigInt) | 求 BigInt 的算术平方根，向下取整。 |
| sqrt(Decimal) | 求 Decimal 的算术平方根。结果为无限小数场景时，默认采用 IEEE 754-2019 decimal128 对结果进行舍入。 |
| trailingZeros(BigInt) | 求 BigInt 的二进制表达中的从最低位算起，连续位为 0 的个数。如果最低位不是 0，则返回 0。 |
枚举
| 枚举 | 功能 |
|---|---|
| OverflowStrategy | 溢出策略枚举类，共包含 3 种溢出策略。BigInt 类型、Decimal 类型转换为整数类型时，允许指定不同的溢出处理策略。 |
结构体
| 结构体 | 功能 |
|---|---|
| BigInt | BigInt 定义为任意精度（二进制）的有符号整数。仓颉的 struct BigInt 用于任意精度有符号整数的计算，类型转换等。 |
| Decimal | Decimal 用于表示任意精度的有符号的十进制数。允许操作过程指定上下文，指定结果精度及舍入规则。提供基础类型 (Int、UInt、String、Float等) 与 BigInt 类型互相转换能力，支持 Decimal 对象基本属性查询等能力，支持基础数学运算操作，提供对象比较、hash、字符串打印等基础能力。 |