普贤教程 › 包参考

cnnum 包

中文数字转换

项	值
包名	`cnnum`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`cnnum.px`
分类	`文本与中文处理`
文件数 / 行数	`1 / 247`

安装与引入

bash

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

import cnnum

所属分类教程：文本与中文处理

公开接口

函数	参数
`cnnum_parse`	`s`
`cnnum_format`	`n`

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

函数	参数
`cn_digit`	`c`
`cn_group`	`n`
`cn_big_digit`	`d`
`cn_big_text`	`s`
`cn_big_group`	`n`
`cn_amount_str`	`s`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/cnnum —— 中文数字转换
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
cnnum_parse(s)   → Ok(int) | Err    "一万二千三百四十五" → 12345
cnnum_format(n)  → Ok(str)         12345 → "一万二千三百四十五"
支持范围：0 ~ 99999999（亿内）；"零"用于位间占位。
说明：
- format 采用自然中文读数（无前导"/"后缀）
- parse 容错：严格模式（非法字符 → Err）；数字前允许"一"省略（如 "十二"）
============================================================