「中文数字」是中文的数字表示方式,例如「123」,可以表示为「一百二十三」。中文数字如同英文字母一样有区分大小写,例如「123」的中文数字小写为「一百二十三」,大写则为「壹佰贰拾参」。至於单位则有个、十、百、千、万、亿、兆、京等等,相同单位的数量级也并非只有一种,而是分为下数、万进、中数和上数这主要四种系统。中文数字是老祖宗的智能,但对于现在的数字系统来说并不怎么合适,还是得经过转换才行。那么要如何使用 Rust 编程语言进行中文数字的转换呢?
在进入 Rust 编程语言之前,先来了解一下下数、万进、中数和上数四种进位系统。北周甄鸾所作的《五经算术》有提到:
拿「一兆」来举例的话,下数的「一兆」对应的数值为 1000000 (106);中数的「一兆」对应的数值为 10000000000000000 (1016);上数的「一兆」对应的数值同中数的「一兆」。以「一京」来举例的话,下数的「一京」对应的数值为 107;中数的「一京」对应的数值为 1024;上数的「一京」对应的数值为 1032。
而我们平常使用的进位系统为「万进」,一遇到「万」就变,因此万进的「一兆」对应的数值为 1000000000000 (1012),「一京」对应的数值为 1016。
Chinese Number
「Chinese Number」是笔者开发的套件,提供了 NumberToChinese 特性,可以让 Rust 编程语言的所有基本数值类型都拥有转成中文数字的能力。也提供 ChineseToNumber 特性,让中文数字的字符串可以转成 Rust 编程语言的基本数值类型。这个套件除了有支持下数、万进、中数和上数这四种进位系统外,还支持繁体字和简体字的大小写。
Crates.io
Cargo.toml
使用方法
范例程序
use chinese_number::{ChineseCase, ChineseCountMethod, ChineseVariant, NumberToChinese, ChineseToNumber};
assert_eq!("一二三", 123i8.to_chinese_naive(ChineseVariant::Traditional, ChineseCase::Lower));
assert_eq!("壹佰貳拾參", 123i8.to_chinese(ChineseVariant::Traditional, ChineseCase::Upper, ChineseCountMethod::TenThousand).unwrap());
assert_eq!("壹佰贰拾叁", 123i8.to_chinese(ChineseVariant::Simple, ChineseCase::Upper, ChineseCountMethod::TenThousand).unwrap());
assert_eq!("一百二十三", 123i8.to_chinese(ChineseVariant::Traditional, ChineseCase::Lower, ChineseCountMethod::TenThousand).unwrap());
assert_eq!("一極二載三正四澗五溝六穰七秭八垓九京零一億二萬三千四百五十六", 1234567890123456i64.to_chinese(ChineseVariant::Traditional, ChineseCase::Lower, ChineseCountMethod::Low).unwrap());
assert_eq!("十二穰三千四百五十六秭七千八百九十垓一千二百三十四京五千六百七十八兆九千零一十二億三千四百五十六萬七千八百九十", 123456789012345678901234567890i128.to_chinese(ChineseVariant::Traditional, ChineseCase::Lower, ChineseCountMethod::TenThousand).unwrap());
assert_eq!("十二萬三千四百五十六京七千八百九十萬一千二百三十四兆五千六百七十八萬九千零一十二億三千四百五十六萬七千八百九十", 123456789012345678901234567890i128.to_chinese(ChineseVariant::Traditional, ChineseCase::Lower, ChineseCountMethod::Middle).unwrap());
assert_eq!("十二萬三千四百五十六億七千八百九十萬一千二百三十四兆五千六百七十八萬九千零一十二億三千四百五十六萬七千八百九十", 123456789012345678901234567890i128.to_chinese(ChineseVariant::Traditional, ChineseCase::Lower, ChineseCountMethod::High).unwrap());
assert_eq!("一角二分", 0.12f64.to_chinese(ChineseVariant::Traditional, ChineseCase::Lower, ChineseCountMethod::TenThousand).unwrap());
assert_eq!(123i8, "一二三".to_number_naive().unwrap());
assert_eq!(123i8, "一百二十三".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(-30303i16, "負三萬零三百零三".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(3212345678u32, "三十二億一千二百三十四萬五千六百七十八".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(10010001001001001000u64, "一千零一京零一兆零一十億零一百萬一千".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(1000000u64, "一兆".to_number(ChineseCountMethod::Low).unwrap());
assert_eq!(1000000000000u64, "一兆".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(10000000000000000u64, "一兆".to_number(ChineseCountMethod::Middle).unwrap());
assert_eq!(10000000000000000u64, "一兆".to_number(ChineseCountMethod::High).unwrap());
assert_eq!(120u64, "一百二".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(2300u64, "兩千三".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(34000u64, "三萬四".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(105000u64, "十萬五".to_number(ChineseCountMethod::TenThousand).unwrap());
assert_eq!(150000000u64, "一億五".to_number(ChineseCountMethod::TenThousand).unwrap());
无标准函数库(No Std)
如果想要让这个套件可以在无标准函数库的情况下被编译,可以关掉预设的特色。数字转中文和中文转数字可分别使用 number-to-chinese 和 chinese-to-number 特色来激活。
[dependencies.chinese-number]
version = "*"
default-features = false
features = ["number-to-chinese", "chinese-to-number"]
