Struct NiceU32 

pub struct NiceU32 { /* private fields */ }

Nice u32.

This struct can be used to quickly and efficiently stringify a u32 primitive (with thousands separators).

Examples

use dactyl::NiceU32;

assert_eq!(
    NiceU32::from(u32::MAX).as_str(),
    "4,294,967,295",
);

Implementations

impl NiceU32

pub const fn as_bytes(&self) -> &[u8]

As Byte Slice.

Return the value as a byte slice.

Examples

use dactyl::NiceU32;

assert_eq!(
    NiceU32::from(u32::MAX).as_bytes(),
    b"4,294,967,295",
);

pub const fn as_str(&self) -> &str

As String Slice.

Return the value as a string slice.

Examples

use dactyl::NiceU32;

assert_eq!(
    NiceU32::from(u32::MAX).as_str(),
    "4,294,967,295",
);

pub const fn is_empty(&self) -> bool

Is Empty?

No! Haha. But for consistency, this method exists.

pub const fn len(&self) -> usize

Length.

Return the length of the nice byte/string representation.

Note this will never be zero.

Examples

use dactyl::NiceU32;

let nice = NiceU32::MAX;
assert_eq!(
    nice.len(),
    nice.as_str().len(),
);

impl NiceU32

pub const MIN: Self

Minimum Value.

The nice equivalent of u32::MIN.

Examples

use dactyl::NiceU32;

assert_eq!(
    NiceU32::MIN.as_str(),
    "0",
);

pub const MAX: Self

Maximum Value.

The nice equivalent of u32::MAX.

Examples

use dactyl::NiceU32;

assert_eq!(
    NiceU32::MAX.as_str(),
    "4,294,967,295",
);

impl NiceU32

pub fn with_separator(src: u32, sep: NiceSeparator) -> Self

New (w/ Alternative Thousands Separator).

Nicely stringify a u32 with a specific thousands separator (instead of the default comma).

Examples

use dactyl::{NiceSeparator, NiceU32};

let num: u32 = 54321;

// Commas are used by default.
assert_eq!(
    NiceU32::from(num).as_str(),
    "54,321",
);

// Other contexts might prefer, say, underscores…
assert_eq!(
    NiceU32::with_separator(
        num,
        NiceSeparator::Underscore,
    ).as_str(),
    "54_321",
);

pub fn replace(&mut self, src: u32)

Replace w/ New Number.

Reuse the backing storage behind self to hold a new nice number.

Examples.

use dactyl::NiceU32;

let mut num = NiceU32::from(1234_u32);
assert_eq!(num.as_str(), "1,234");

num.replace(1);
assert_eq!(num.as_str(), "1");

Trait Implementations

impl AsRef<[u8]> for NiceU32

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for NiceU32

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<str> for NiceU32

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl Clone for NiceU32

fn clone(&self) -> NiceU32

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for NiceU32

impl Debug for NiceU32

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

Formats the value using the given formatter.

impl Default for NiceU32

fn default() -> Self

Returns the “default value” for a type.

impl Display for NiceU32

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

Formats the value using the given formatter.

impl Eq for NiceU32

impl From<NiceU32> for String

fn from(src: NiceU32) -> Self

Converts to this type from the input type.

impl From<NonZero<u32>> for NiceU32

fn from(src: NonZeroU32) -> Self

Converts to this type from the input type.

impl From<Option<NonZero<u32>>> for NiceU32

fn from(src: Option<NonZeroU32>) -> Self

Converts to this type from the input type.

impl From<Option<u32>> for NiceU32

fn from(src: Option<u32>) -> Self

Converts to this type from the input type.

impl From<u32> for NiceU32

fn from(src: u32) -> Self

Converts to this type from the input type.

impl Hash for NiceU32

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Inflection> NiceInflection<NiceU32> for T

where NiceU32: From<T>,

fn nice_inflect<'a>( self, singular: &'a str, plural: &'a str, ) -> NiceInflected<'a, NiceU32>

Inflect a String.

impl NiceInflection<NiceU32> for i32

fn nice_inflect<'a>( self, singular: &'a str, plural: &'a str, ) -> NiceInflected<'a, NiceU32>

Inflect a String.

impl Ord for NiceU32

fn cmp(&self, rhs: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for NiceU32

fn eq(&self, rhs: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for NiceU32

fn partial_cmp(&self, rhs: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.