Struct NumStr

pub struct NumStr<const B: u8 = 10, const U: bool = false, const R: usize = 0, const M: usize = 0, T = usize>(/* private fields */);

Number to string

Generic

• B: the base of the number, should be within the range 2..=16. Default is 10.

• U: whether to use uppercase for hex. Default is lowercase (false).

  For float number, U means whether only to reserve the integer part.

• R: the resize length of the string. The overflow part will be truncated, and the insufficient part will be filled with ‘0’. Default is 0, or no resize.

• M: the minimum length of the string, if the length of the string is less than M, fill with ‘0’. Default is 0, or no minimum. For signed number M will be ignored.

• T: the underlying type of the number. Default is usize.

Panic

• Invalid base (== 0 or > 16)

Implementations

impl<T> NumStr<10, false, 0, 0, T>

pub fn new_default(inner: T) -> Self

Create a new NumStr with the given number.

With default settings of B, U, R, M:

• B: 10
• U: false
• R: 0
• M: 0

See NumStr for details.

If you want a hexadecimal number, chains with NumStr::hexadecimal().

Notice

For negative number, R, M will not make sense

Examples

NumStr::new_default(123_i16)

pub fn hex_default(inner: T) -> NumStr<16, false, 0, 0, T>

Create a new NumStr with the given number.

With default settings of B, U, R, M:

• B: 16
• U: false
• R: 0
• M: 0

See NumStr for details.

Notice

For negative number, R, M will not make sense

Examples

NumStr::hex_default(123_i16)

impl NumStr<10, false, 0, 0, u8>

pub fn hex_byte_default(inner: u8) -> NumStr<16, false, 2, 0, u8>

Create a new NumStr with the given number, mostly for encoding bytes to hex.

With default settings of B, U, R, M:

• B: 16
• U: false
• R: 2
• M: 0

See NumStr for details.

Notice

For negative number, R, M will not make sense

Examples

let nums = vec![0x11, 0x45, 0x14, 0x19, 0x19, 0x81, 0x00]
    .into_iter()
    .map(NumStr::hex_byte_default);

assert_eq!(nums.to_string_ext(), "11451419198100");

impl<const B: u8, const U: bool, const R: usize, const M: usize, T> NumStr<B, U, R, M, T>

pub fn new(inner: T) -> Self

Create a new NumStr with the given number.

pub fn decimal(self) -> NumStr<10, U, R, M, T>

Convert to decimal representation.

pub fn hexadecimal(self) -> NumStr<16, U, R, M, T>

Convert to hexadecimal representation.

pub fn set_custom_base<const NB: u8>(self) -> NumStr<NB, U, R, M, T>

Set custom base.

The valid range is 2..=16

pub fn set_uppercase<const NU: bool>(self) -> NumStr<B, NU, R, M, T>

Set uppercase / lowercase of the number.

Default is lowercase

Note: only works for base > 10

pub fn set_resize_len<const NR: usize>(self) -> NumStr<B, U, NR, M, T>

Set whether to resize the string to len length.

The overflow part will be truncated, and the insufficient part will be filled with ‘0’

Default is not resize

Note: see Vec::resize for details

pub fn set_minimum_len<const NM: usize>(self) -> NumStr<B, U, R, NM, T>

Set the minimum length of the string.

The insufficient part will be filled with ‘0’.

Default is not minimum

Note: if set Self::should_resize, the minimum length will be ignored

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, f32>

pub fn set_integer_only<const NU: bool>(self) -> NumStr<B, NU, R, M, f32>

Set integer only mode.

Default disable.

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, f64>

pub fn set_integer_only<const NU: bool>(self) -> NumStr<B, NU, R, M, f64>

Set integer only mode.

Default disable.

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, u8>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, u16>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, u32>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, u64>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, u128>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, usize>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, i8>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, i16>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, i32>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, i64>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, i128>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

impl<const B: u8, const U: bool, const R: usize, const M: usize> NumStr<B, U, R, M, isize>

pub fn encode(self, string: &mut Vec<u8>)

Encode the number to the str

Trait Implementations

impl<const B: u8, const U: bool, const R: usize, const M: usize, T> AsRef<T> for NumStr<B, U, R, M, T>

fn as_ref(&self) -> &T

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

impl<const B: u8, const U: bool, const R: usize, const M: usize, T: Clone> Clone for NumStr<B, U, R, M, T>

fn clone(&self) -> NumStr<B, U, R, M, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const B: u8, const U: bool, const R: usize, const M: usize, T: Debug> Debug for NumStr<B, U, R, M, T>

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

Formats the value using the given formatter.

impl<const B: u8, const U: bool, const R: usize, const M: usize, T> Deref for NumStr<B, U, R, M, T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<const B: u8, const U: bool, const R: usize, const M: usize, T> DerefMut for NumStr<B, U, R, M, T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<const B: u8, const U: bool, const R: usize, const M: usize, T: Ord> Ord for NumStr<B, U, R, M, T>

fn cmp(&self, other: &NumStr<B, U, R, M, T>) -> 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<const B: u8, const U: bool, const R: usize, const M: usize, T: PartialEq> PartialEq for NumStr<B, U, R, M, T>

fn eq(&self, other: &NumStr<B, U, R, M, T>) -> 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<const B: u8, const U: bool, const R: usize, const M: usize, T: PartialOrd> PartialOrd for NumStr<B, U, R, M, T>

fn partial_cmp(&self, other: &NumStr<B, U, R, M, T>) -> 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.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, usize>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, f32>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, f64>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, i128>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, i16>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, i32>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, i64>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, i8>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, isize>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, u128>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, u16>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, u32>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, u64>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize> StringExtT for NumStr<B, U, R, M, u8>

fn push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

fn with_prefix<P: StringExtT>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT>(self, suffix: S) -> impl StringExtT

With suffix.

impl<const B: u8, const U: bool, const R: usize, const M: usize, T: Copy> Copy for NumStr<B, U, R, M, T>

impl<const B: u8, const U: bool, const R: usize, const M: usize, T: Eq> Eq for NumStr<B, U, R, M, T>

impl<const B: u8, const U: bool, const R: usize, const M: usize, T> StructuralPartialEq for NumStr<B, U, R, M, T>