mod format;
use format::append_number;
pub(crate) use format::append_i64 as format_i64;
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct Config {
pub precision: i32,
pub max_precision: i32,
}
impl Default for Config {
fn default() -> Self {
Self::new()
}
}
impl Config {
pub const fn new() -> Self {
Self {
precision: 0,
max_precision: -1,
}
}
pub const fn precision(mut self, p: i32) -> Self {
self.precision = p;
self
}
pub const fn max_precision(mut self, p: i32) -> Self {
self.max_precision = p;
self
}
}
const POWERS: [f64; 6] = [1.0, 1e3, 1e6, 1e9, 1e12, 1e15];
const SHORT_SUFFIXES: [&str; 6] = ["", "K", "M", "B", "T", "Q"];
const LONG_SUFFIXES: [&str; 6] = [
"",
" thousand",
" million",
" billion",
" trillion",
" quadrillion",
];
pub fn abbreviate(number: f64, cfg: Config) -> String {
let mut s = String::with_capacity(24);
append_abbreviate(&mut s, number, cfg);
s
}
pub fn for_humans(number: f64, cfg: Config) -> String {
let mut s = String::with_capacity(32);
append_for_humans(&mut s, number, cfg);
s
}
#[inline]
pub fn append_abbreviate(out: &mut String, number: f64, cfg: Config) {
append_with(out, number, cfg, &SHORT_SUFFIXES)
}
#[inline]
pub fn append_for_humans(out: &mut String, number: f64, cfg: Config) {
append_with(out, number, cfg, &LONG_SUFFIXES)
}
fn append_with(out: &mut String, number: f64, cfg: Config, units: &[&str; 6]) {
let number = if number < 0.0 {
out.push('-');
-number
} else {
number
};
summarize(out, number, cfg, units)
}
fn summarize(out: &mut String, number: f64, cfg: Config, units: &[&str; 6]) {
if number == 0.0 {
return append_number(out, 0.0, cfg.precision, cfg.max_precision);
}
if number >= 1e15 {
summarize(out, number / 1e15, cfg, units);
out.push_str(units[5]);
return;
}
let idx = if number >= 1e12 {
4
} else if number >= 1e9 {
3
} else if number >= 1e6 {
2
} else if number >= 1e3 {
1
} else {
return append_number(out, number, cfg.precision, cfg.max_precision);
};
append_number(out, number / POWERS[idx], cfg.precision, cfg.max_precision);
out.push_str(units[idx]);
}
#[doc(hidden)]
pub fn format_number(number: f64, precision: i32, max_precision: i32) -> String {
let mut s = String::with_capacity(24);
append_number(&mut s, number, precision, max_precision);
s
}