普贤教程 › 包参考

decimal 包

任意精度十进制数

项	值
包名	`decimal`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`decimal.px`
分类	`数学与统计`
文件数 / 行数	`1 / 536`

安装与引入

bash

pxpkg init          # 首次
pxpkg add decimal@0.2.0
pxpkg install

import decimal

所属分类教程：数学与统计

公开接口

函数	参数
`dec_add`	`a, b`
`dec_sub`	`a, b`
`dec_mul`	`a, b`
`dec_div`	`a, b, places`
`dec_cmp`	`a, b`
`dec_abs`	`a`
`dec_neg`	`a`
`dec_is_zero`	`a`
`dec_round`	`a, places, mode = "half_up"`

其余 19 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`dec_is_digit`	`c`
`dec_parse`	`s`
`dec_repeat`	`s, n`
`dec_err_msg`	`r`
`dec_norm`	`d`
`dec_is_zero_str`	`s`
`dec_add_str`	`a, b`
`dec_sub_str`	`a, b`
`dec_cmp_abs`	`a, b`
`dec_mul_digit`	`a, d`
`dec_mul_str`	`a, b`
`dec_divmod`	`A, B`
`dec_align_int`	`digits, scale, target_scale`
`dec_pow`	`a, n`
`dec_sqrt`	`a, places = 10`
`dec_mod`	`a, b, places = 10`
`dec_min`	`a, b`
`dec_max`	`a, b`
`dec_format_thousands`	`a, places = 2`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/decimal —— 任意精度十进制数
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
dec_add(a, b) / dec_sub(a, b) / dec_mul(a, b) / dec_div(a, b, places)
dec_cmp(a, b) -> -1 | 0 | 1
dec_round(a, places, mode?)   mode: half_up(默认) / half_even / down / up
dec_abs(a) / dec_neg(a) / dec_is_zero(a)
内部表示：{sign, digits, scale}，value = sign * digits × 10^-scale
全字符串竖式算法，无浮点参与 → 金额/精度场景安全。
============================================================
---- 内部：解析与规范化 ----