Struct shortscale::extra::NumWords

pub struct NumWords { /* fields omitted */ }

Expose shortscale Display trait implementation
for easy to_string() or write!() into an existing String.

This experiment was supposed to be faster than shortscale because we can eliminate the allocation of a new String. However, the overhead of making multiple fmt::Formatter.write_str() calls turned out to be greater than the cost of String allocation.

The simpler solution was to add a string writer function to shortscale directly mutating an existing string, rother than going through the formatter code.

Example

use shortscale;
use std::fmt::Write;

let mut buf = String::with_capacity(100);
let numwords = shortscale::extra::NumWords::new(420_000_999_015);

// write to buffer
println!("buf.len() before: {}", buf.len());
write!(&mut buf, "{}", numwords).unwrap();
println!("buf.len()  after: {}", buf.len());

// or simply convert to String (may do multiple allocs)
assert_eq!(
    numwords.to_string(),
    "four hundred and twenty billion nine hundred \
    and ninety nine thousand and fifteen"
    );

Implementations

impl NumWords

pub fn new(n: u64) -> Self

Trait Implementations

impl Debug for NumWords

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for NumWords

fn fmt(&self, f: &mut Fmt<'_>) -> Result

Formats the value using the given formatter.