Struct FmtNum 

pub struct FmtNum<T>(pub T);

🖹 ⅀ Const number formatter.

---

^{📍 text/fmt}

---

Provides a lightweight, allocation-free interface for writing numeric values into an existing byte buffer.

Examples

let mut buf = [0u8; 8];
let len = FmtNum(-123i32).write(&mut buf, 0);
assert_eq!(&buf[..len], b"-123");

let len = FmtNum(42u8).write(&mut buf, 0);
assert_eq!(&buf[..len], b"42");

let float_str = FmtNum(-4.2_f32).as_str_into(&mut buf, 2);
assert_eq!(float_str, "-4.19"); // be aware of floating-point inexactitudes

Tuple Fields

0: T

Implementations

impl FmtNum<f32>

pub const fn write(self, buf: &mut [u8], pos: usize, fract_len: u16) -> usize

Writes the floating-point number in fixed-point decimal form into buf starting at pos, using exactly fract_len fractional digits.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The operation is atomic: on failure, nothing is written.
• Negative values are preceded by the '-' sign.
• Fractional digits are truncated and zero-padded as needed.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the floating-point number in fixed-point decimal form into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The operation is atomic: on failure, nothing is written.
• The emitted sign, any leading zero-padding, and the number of fractional digits are controlled by conf.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted floating-point number with optional digit grouping.

Grouping is applied to the rendered digit sequences on both sides of the radix, after sign emission, zero-padding, and precision handling have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (integral digits + zero padding + grouping separators), excluding the sign.
• conf.fract specifies the fractional precision before grouping is applied to the rendered fractional digit sequence.
• On failure, nothing is written (atomic operation).

pub const fn measure(self, fract_len: u16) -> FmtNumShape

Returns the measured shape of the floating-point to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the floating-point to be formatted, using the given formatting configuration.

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

Grouping assumes 1-byte separators and ASCII digits.

pub const fn as_bytes_into<'b>( &self, buf: &'b mut [u8], fract_len: u16, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

This operation is atomic: if the buffer is too small, nothing is writte.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

This operation is atomic: if the buffer is too small, nothing is writte.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], fract_len: u16, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as a byte slice.

This operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

This operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>( &self, buf: &'b mut [u8], fract_len: u16, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

This operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

This operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], fract_len: u16, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as a string slice.

This operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

This operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self, fract_len: u16) -> StringU8<N>

Converts the number into an owned fixed-size string.

This operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

This operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>( &self, fract_len: u16, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

This operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

This operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<f64>

pub const fn write(self, buf: &mut [u8], pos: usize, fract_len: u16) -> usize

Writes the floating-point number in fixed-point decimal form into buf starting at pos, using exactly fract_len fractional digits.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The operation is atomic: on failure, nothing is written.
• Negative values are preceded by the '-' sign.
• Fractional digits are truncated and zero-padded as needed.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the floating-point number in fixed-point decimal form into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The operation is atomic: on failure, nothing is written.
• The emitted sign, any leading zero-padding, and the number of fractional digits are controlled by conf.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted floating-point number with optional digit grouping.

Grouping is applied to the rendered digit sequences on both sides of the radix, after sign emission, zero-padding, and precision handling have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (integral digits + zero padding + grouping separators), excluding the sign.
• conf.fract specifies the fractional precision before grouping is applied to the rendered fractional digit sequence.
• On failure, nothing is written (atomic operation).

pub const fn measure(self, fract_len: u16) -> FmtNumShape

Returns the measured shape of the floating-point to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the floating-point to be formatted, using the given formatting configuration.

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

Grouping assumes 1-byte separators and ASCII digits.

pub const fn as_bytes_into<'b>( &self, buf: &'b mut [u8], fract_len: u16, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

This operation is atomic: if the buffer is too small, nothing is writte.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

This operation is atomic: if the buffer is too small, nothing is writte.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], fract_len: u16, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as a byte slice.

This operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

This operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>( &self, buf: &'b mut [u8], fract_len: u16, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

This operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

This operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], fract_len: u16, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as a string slice.

This operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

This operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self, fract_len: u16) -> StringU8<N>

Converts the number into an owned fixed-size string.

This operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

This operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>( &self, fract_len: u16, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

This operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

This operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<i8>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• Negative values are preceded by the '-' sign.
• The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The emitted sign and any leading zero-padding are controlled by conf.
• The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer when formatted with the given configuration.

impl FmtNum<i8>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<i16>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• Negative values are preceded by the '-' sign.
• The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The emitted sign and any leading zero-padding are controlled by conf.
• The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer when formatted with the given configuration.

impl FmtNum<i16>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<i32>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• Negative values are preceded by the '-' sign.
• The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The emitted sign and any leading zero-padding are controlled by conf.
• The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer when formatted with the given configuration.

impl FmtNum<i32>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<i64>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• Negative values are preceded by the '-' sign.
• The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The emitted sign and any leading zero-padding are controlled by conf.
• The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer when formatted with the given configuration.

impl FmtNum<i64>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<i128>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• Negative values are preceded by the '-' sign.
• The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The emitted sign and any leading zero-padding are controlled by conf.
• The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer when formatted with the given configuration.

impl FmtNum<i128>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<isize>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• Negative values are preceded by the '-' sign.
• The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

• The emitted sign and any leading zero-padding are controlled by conf.
• The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer when formatted with the given configuration.

impl FmtNum<isize>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<u8>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The emitted sign and any leading zero-padding are controlled by conf. The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer to be formatted, using the given formatting configuration.

impl FmtNum<u8>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<u16>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The emitted sign and any leading zero-padding are controlled by conf. The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer to be formatted, using the given formatting configuration.

impl FmtNum<u16>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<u32>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The emitted sign and any leading zero-padding are controlled by conf. The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer to be formatted, using the given formatting configuration.

impl FmtNum<u32>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<u64>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The emitted sign and any leading zero-padding are controlled by conf. The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer to be formatted, using the given formatting configuration.

impl FmtNum<u64>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<u128>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The emitted sign and any leading zero-padding are controlled by conf. The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer to be formatted, using the given formatting configuration.

impl FmtNum<u128>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

impl FmtNum<usize>

pub const fn write(self, buf: &mut [u8], pos: usize) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The operation is atomic: on failure, nothing is written.

pub const fn write_fmt( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, ) -> usize

Writes the integer as ASCII decimal digits into buf starting at pos, using the given formatting configuration.

Returns the number of bytes written, or 0 if the buffer is too small.

Behavioral guarantees

The emitted sign and any leading zero-padding are controlled by conf. The operation is atomic: on failure, nothing is written.

pub const fn write_group( self, buf: &mut [u8], pos: usize, conf: FmtNumConf, group: FmtNumGroup, ) -> usize

Writes the formatted integer with optional digit grouping.

Grouping is applied to the rendered integral digit sequence, after sign emission and zero-padding have been accounted for.

Behavioral guarantees

• Grouping assumes 1-byte separators and ASCII digits.
• conf.int specifies the minimum width of the entire left block (digits + zero padding + grouping separators), excluding the sign.
• On failure, nothing is written (atomic operation).

pub const fn measure(self) -> FmtNumShape

Returns the measured shape of the integer to be formatted.

pub const fn measure_fmt(self, conf: FmtNumConf) -> FmtNumShape

Returns the measured shape of the integer to be formatted, using the given formatting configuration.

impl FmtNum<usize>

pub const fn measure_group( self, conf: FmtNumConf, group: FmtNumGroup, ) -> FmtNumShape

Returns the measured shape of the number after applying digit grouping.

This first measures the formatted number using measure_fmt, then accounts for any additional separator glyphs introduced by grouping.

pub const fn as_bytes_into<'b>(&self, buf: &'b mut [u8]) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b [u8]

Formats the number into a provided buffer and returns it as a byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

pub const fn as_bytes_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_bytes_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b [u8]>

Formats the number into a provided buffer and returns it as some byte slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

pub const fn as_str_into<'b>(&self, buf: &'b mut [u8]) -> &'b str

Formats the number into a provided buffer and returns it as a string slice.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> &'b str

Formats the number into a provided buffer and returns it as a string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked<'b>( &self, buf: &'b mut [u8], ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice.

The operation is atomic: if the buffer is too small, nothing is written and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_str_into_checked_fmt<'b>( &self, buf: &'b mut [u8], conf: FmtNumConf, ) -> Option<&'b str>

Formats the number into a provided buffer and returns it as some string slice, using the given formatting configuration.

The operation is atomic: if the buffer is too small, nothing is written, and it returns None.

Features

Uses the unsafe_str feature to avoid duplicated validation.

pub const fn as_string<const N: usize>(&self) -> StringU8<N>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> StringU8<N>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns an empty string.

pub const fn as_string_checked<const N: usize>(&self) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string.

The operation is atomic: if the buffer is too small, it returns None.

pub const fn as_string_checked_fmt<const N: usize>( &self, conf: FmtNumConf, ) -> Option<StringU8<N>>

Converts the number into an owned fixed-size string, using the given formatting configuration.

The operation is atomic: if the buffer is too small, it returns None.

Trait Implementations

impl<T: Clone> Clone for FmtNum<T>

fn clone(&self) -> FmtNum<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Copy> Copy for FmtNum<T>

impl<T: Debug> Debug for FmtNum<T>

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

Formats the value using the given formatter.

impl<T: Eq> Eq for FmtNum<T>

impl<T: Hash> Hash for FmtNum<T>

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: Ord> Ord for FmtNum<T>

fn cmp(&self, other: &FmtNum<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<T: PartialEq> PartialEq for FmtNum<T>

fn eq(&self, other: &FmtNum<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<T: PartialOrd> PartialOrd for FmtNum<T>

fn partial_cmp(&self, other: &FmtNum<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<T> StructuralPartialEq for FmtNum<T>