#string #string-format #numbers #ordinal #cardinals

rust-numerals

Crate for converting i64 integers into their cardinal string format

1 unstable release

0.1.0 Sep 8, 2023

#366 in Value formatting


Used in 2 crates (via sw4rm-rs-generation)

Custom license

14KB
148 lines

Rust Numerals

Crate for converting i64 integers into their cardinal string format.

TODO

  • Support localisation;
  • Comma-support inside large strings;
  • number_to_ordinal method for ordinals;
  • number_to_roman method for Roman ordinals;
  • Support multiple integer types i8 .. i32 & u8 .. u64;
  • Support multiple integer types i8 .. i32 & u8 .. u64;
  • Support floating point numbers f32 & f64;

Getting started

Add the following lines to your Cargo.toml dependencies:

[dependencies]
rust-numerals = "0.1.0"

Examples

Convert a number to it's ordinal words.

use rust_numerals::number_to_cardinal;

fn main() {
    let number: i64 = 23;
    let cardinal = number_to_cardinal(23);
    println!("{} == {}", number, cardinal); // 23 == twenty-three
}

More examples

Using the i64 we can get numbers into the quintillions, which is probably larger than most projects needs.

number_to_cardinal(0); // zero
number_to_cardinal(8); // eight
number_to_cardinal(14); // fourteen
number_to_cardinal(23); // twenty-three
number_to_cardinal(108); // one hundred eight
number_to_cardinal(1256); // one thousand two hundred and fifty-six
number_to_cardinal(1_100); // one thousand one hundred
number_to_cardinal(11_011); // eleven thousand eleven
number_to_cardinal(21_025); // twenty-one thousand twenty-five
number_to_cardinal(99_999); // ninety-nine thousand nine hundred and ninety-nine
number_to_cardinal(1_001_000); // one million one thousand
number_to_cardinal(1_061_044); // one million sixty-one thousand forty-four
number_to_cardinal(2_000_000_000_000); // two trillion
number_to_cardinal(2_000_892_000_560_056_000); // two quintillion eight hundred and ninety-two trillion five hundred and sixty million fifty-six thousand
number_to_cardinal(1_100_100_100_100_100_101); // one quintillion one hundred quadrillion one hundred trillion one hundred billion one hundred million one hundred thousand one hundred and one

License

Licensed under MIT license (LICENSE or https://opensource.org/licenses/MIT).

No runtime deps