cardinalize_numbers

Crates.iocardinalize_numbers
lib.rscardinalize_numbers
version0.1.0
created_at2025-04-28 00:53:02.575795+00
updated_at2025-04-28 00:53:02.575795+00
descriptionA Rust library for converting numbers into their cardinal English text representation
homepage
repositoryhttps://github.com/kmooney/cardinalize_numbers
max_upload_size
id1651641
size8,375
Kevin Mooney (kmooney)

documentation

README

Cardinalize Numbers

A Rust library that converts numbers into their cardinal English text representation.

Features

  • Converts integers to English text (e.g., 123 → "one hundred twenty three")
  • Supports numbers up to the trillions
  • US English spelling and formatting

Usage

Add this to your Cargo.toml:

[dependencies]
cardinalize_numbers = "0.1.0"

Then use it in your code:

use cardinalize_numbers::cardinalize_us_en;

fn main() {
    let number = 123456;
    let text = cardinalize_us_en(number);
    println!("{}: {}", number, text); // Outputs: 123456: one hundred twenty three thousand four hundred fifty six
}

Example Output

1 → "one"
100 → "one hundred"
575 → "five hundred seventy five"
8575 → "eight thousand five hundred seventy five"
1398575 → "one million three hundred ninety eight thousand five hundred seventy five"

Testing

Run the tests with:

cargo test

License

This project is available as open source under the terms of the MIT License.

Commit count: 3

cargo fmt