Romantic 🏛

Rust 的罗马数字库。

API

完整文档请参阅 docs.rs.

示例

使用默认的罗马数字系统。

use romantic::Roman;

let roman = Roman::default();

assert_eq!(roman.to_string(2022).unwrap(), "MMXXII");
assert_eq!(roman.from_str::<i32>("MMXXII").unwrap(), 2022);

// The default Roman numeral system has a maximum of 3999.
assert!(roman.to_string(4000).is_err());

使用您自己的自定义字符集。

use romantic::Roman;

// The order of characters in the array determines their value.
// Here, A equals 1 and B equals 5.
let custom = Roman::new(&['A', 'B']);

assert_eq!(custom.to_string(6).unwrap(), "BA");
assert_eq!(custom.from_str::<i32>("BA").unwrap(), 6);

// With only 2 characters, the maximum value you can get is 8
// (the equivalent of VIII). To increase the maximum range, use
// more characters.
assert!(custom.to_string(9).is_err());

开发

在安装并启用 Nix flakes 和 direnv 后，所有必需的依赖项都将自动从 shell.nix 加载。然后可以使用 cargo-make 构建代码、部署和检查代码。可用的任务都在 Makefile.toml 配置文件中描述。

反馈

发现了一个问题或想要请求一个新功能？请发送电子邮件至 [email protected]，我将尽力为您解决问题。

许可协议

在 Apache License 2.0 和 MIT 许可协议下分发，有关更多信息，请参阅 LICENSE-Apache 和 LICENSE-MIT。