Expand description
中文火星文转换库:可逆的单字符字形替换。
一个字符进、一个字符出,不依赖上下文,因此 decode(encode(s)) == s 恒成立。
可逆性不靠记录操作历史,而是靠映射表本身的三条规则(见 Table):
候选不等于原字、候选全局唯一、候选不能同时是别人的原字。
use marspeak::Builder;
let m = Builder::new().seed(42).intensity(0.6).build().unwrap();
let encoded = m.encode("我爱你");
assert_eq!(m.decode(&encoded), "我爱你");§两个容易踩的语义
- intensity 是概率,不是“前 N 个字“。它表示约有百分之多少的「有映射字符」 被替换,具体哪些由哈希决定。表里没有的字符(ASCII、emoji、空白)永远原样通过。
decode是无条件的。它会还原输入里所有能反查的字符,跟 encode 时用了 多少 intensity 无关。所以decode一段别人写的火星文同样会生效——这是有意 的设计后果,不是 bug。
§确定性
同一组 (seed, intensity, table) 永远得到同一份输出。哈希是手写的 FNV-1a,
不依赖任何外部状态或平台特性。
Structs§
- Builder
Marspeak的构造器。默认 seed = 0、intensity = 1.0、用内置表。- Marspeak
- 一个配置好的转换器。由
Builder产出,可重复使用。 - Table
- 一张字符映射表。
Enums§
- Marspeak
Error - 构造
Marspeak时的参数错误。 - Table
Error - 映射表解析失败的原因。每条都对应
Table::parse的一条校验规则, 并且都带上出错的行号,方便直接定位到 TSV 的那一行。