numan 0.1.0

Humanize numbers: compact (1.2K), word (1.2 million) and SI metric (1.2 k) notation, plus parsing them back. Zero-dependency, no_std.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

//! English ordinal suffixes (`1st`, `2nd`, `3rd`, `4th`, …).

use alloc::format;
use alloc::string::String;

use crate::number::Integer;

/// Format an integer with its English ordinal suffix: `1` → `"1st"`,
/// `22` → `"22nd"`, `113` → `"113th"`.
///
/// Negative numbers keep their sign (`-1` → `"-1st"`). The suffix is chosen from
/// the magnitude, so `-21` → `"-21st"`.
///
/// # Note
///
/// `u128`/`usize` inputs above `i128::MAX` (~1.7e38) saturate to `i128::MAX`
/// before formatting. This is unreachable on 64-bit platforms and far outside any
/// realistic ordinal use.
#[must_use]
pub fn ordinal<I: Integer>(n: I) -> String {
    let v = n.to_i128();
    // `unsigned_abs` avoids overflow at `i128::MIN`.
    let abs = v.unsigned_abs();
    let last_two = (abs % 100) as u64;
    let last_one = (abs % 10) as u64;

    let suffix = if (11..=13).contains(&last_two) {
        "th"
    } else {
        match last_one {
            1 => "st",
            2 => "nd",
            3 => "rd",
            _ => "th",
        }
    };

    let mut s = format!("{v}");
    s.push_str(suffix);
    s
}