devela::all

Struct Ascii

Source 
#[repr(transparent)]
pub struct Ascii<T: Copy>(pub T);
Expand description

Provides ASCII operations on T, most of them const.

Tuple Fields§

§0: T

Implementations§

Source§

impl Ascii<usize>

Source

pub const MAX_DIGITS: usize = 20usize

The maximum number of decimal digits a usize can represent in the current platform.

Source

pub const fn calc_digit(self, divisor: usize) -> u8 ⓘ

Returns the ASCII byte of a specific digit in a usize number.

§Arguments
  • divisor: A power of 10 used to determine which digit to extract.
§Examples
assert_eq!(Ascii(12345_usize).calc_digit(10), b'4');
assert_eq!(Ascii(12345_usize).calc_digit(1000), b'2');
Source

pub const fn count_digits(self) -> u8 ⓘ

Counts the number of decimal digits.

For more complex needs check the Int base methods.

§Examples
assert_eq![1, Ascii(0_usize).count_digits()];
assert_eq![4, Ascii(9876_usize).count_digits()];
Source

pub const fn digits(self) -> [u8; 20]

Converts a usize into a byte array of 20 ascii digits with leading zeros.

The actual array length depends on the target platform’s pointer size.

You can trim the leading zeros with trim_leading_bytes.

Source

pub const fn digits_str(self, width: u8) -> StringU8<{ Self::MAX_DIGITS }>

Available on crate feature string_u8 only.

Returns a static string with zero-padded digits with minimum width.

The given width will be clamped betweeen the actual number of digits and the maximum number of digits.

§Features
  • Will only be const if the _cmp_u8 feature is enabled.
  • Makes use of the unsafe_str feature if enabled.
Source§

impl Ascii<u8>

Source

pub const MAX_DIGITS: usize = 3usize

The maximum number of decimal digits a u8 can represent.

Source

pub const fn calc_digit(self, divisor: u8) -> u8 ⓘ

Returns the ASCII byte of a specific digit in a u8 number.

§Arguments
  • divisor: A power of 10 used to determine which digit to extract.
§Examples
assert_eq!(Ascii(123_u8).calc_digit(10), b'2');
assert_eq!(Ascii(123_u8).calc_digit(100), b'1');
Source

pub const fn count_digits(self) -> u8 ⓘ

Counts the number of decimal digits.

For more complex needs check the Int base methods.

§Examples
assert_eq![1, Ascii(0_u8).count_digits()];
assert_eq![3, Ascii(123_u8).count_digits()];
Source

pub const fn digits(self) -> [u8; 3]

Converts a u8 into a byte array of 3 ASCII digits with leading zeros.

You can trim the leading zeros with trim_leading_bytes.

Source

pub const fn digits_str(self, width: u8) -> StringU8<3>

Available on crate feature string_u8 only.

Returns a static string with zero-padded digits with minimum width.

The given width will be clamped betweeen the actual number of digits and the maximum number of digits.

§Features
  • Will only be const if the _cmp_u8 feature is enabled.
  • Makes use of the unsafe_str feature if enabled.
Source

pub const fn digits_1(self) -> u8 ⓘ

Converts a one-digit number to the corresponding 1 ASCII digit.

§Panics

This function panics in debug if the given number is > 9.

Source

pub const fn digits_2(self) -> [u8; 2]

Converts a two-digit number to the corresponding 2 ASCII digits.

§Panics

This function panics in debug if the given number is > 99.

Source§

impl Ascii<u16>

Source

pub const MAX_DIGITS: usize = 5usize

The maximum number of decimal digits a u16 can represent.

Source

pub const fn calc_digit(self, divisor: u16) -> u8 ⓘ

Returns the ASCII byte of a specific digit in a u16 number.

§Arguments
  • divisor: A power of 10 used to determine which digit to extract.
§Examples
assert_eq!(Ascii(12345_u16).calc_digit(10), b'4');
assert_eq!(Ascii(12345_u16).calc_digit(1000), b'2');
Source

pub const fn count_digits(self) -> u8 ⓘ

Counts the number of decimal digits.

For more complex needs check the Int base methods.

§Examples
assert_eq![1, Ascii(0_u16).count_digits()];
assert_eq![4, Ascii(9876_u16).count_digits()];
Source

pub const fn digits(self) -> [u8; 5]

Converts a u16 into a byte array of 5 ASCII digits with leading zeros.

You can trim the leading zeros with trim_leading_bytes.

Source

pub const fn digits_str(self, width: u8) -> StringU8<5>

Available on crate feature string_u8 only.

Returns a static string with zero-padded digits with minimum width.

The given width will be clamped betweeen the actual number of digits and the maximum number of digits.

§Features
  • Will only be const if the _cmp_u8 feature is enabled.
  • Makes use of the unsafe_str feature if enabled.
Source

pub const fn digits_3(self) -> [u8; 3]

Converts a three-digit number to the corresponding 3 ASCII digits.

§Panics

This function panics in debug if the given number is > 999.

Source

pub const fn digits_4(self) -> [u8; 4]

Converts a four-digit number to the corresponding 4 ASCII digits.

§Panics

This function panics in debug if the given number is > 9999.

Source§

impl Ascii<u32>

Source

pub const MAX_DIGITS: usize = 10usize

The maximum number of decimal digits a u32 can represent.

Source

pub const fn calc_digit(self, divisor: u32) -> u8 ⓘ

Returns the ASCII byte of a specific digit in a u32 number.

§Arguments
  • divisor: A power of 10 used to determine which digit to extract.
§Examples
assert_eq!(Ascii(12345_u32).calc_digit(10), b'4');
assert_eq!(Ascii(12345_u32).calc_digit(1000), b'2');
Source

pub const fn count_digits(self) -> u8 ⓘ

Counts the number of decimal digits.

For more complex needs check the Int base methods.

§Examples
assert_eq![1, Ascii(0_u32).count_digits()];
assert_eq![4, Ascii(9876_u32).count_digits()];
Source

pub const fn digits(self) -> [u8; 10]

Converts a u32 into a byte array of 10 ASCII digits with leading zeros.

You can trim the leading zeros with trim_leading_bytes.

Source

pub const fn digits_str(self, width: u8) -> StringU8<10>

Available on crate feature string_u8 only.

Returns a static string with zero-padded digits with minimum width.

The given width will be clamped betweeen the actual number of digits and the maximum number of digits.

§Features
  • Will only be const if the _cmp_u8 feature is enabled.
  • Makes use of the unsafe_str feature if enabled.
Source§

impl Ascii<u64>

Source

pub const MAX_DIGITS: usize = 20usize

The maximum number of decimal digits a u64 can represent.

Source

pub const fn calc_digit(self, divisor: u64) -> u8 ⓘ

Returns the ASCII byte of a specific digit in a u64 number.

§Arguments
  • divisor: A power of 10 used to determine which digit to extract.
§Examples
assert_eq!(Ascii(12345_u64).calc_digit(10), b'4');
assert_eq!(Ascii(12345_u64).calc_digit(1000), b'2');
Source

pub const fn count_digits(self) -> u8 ⓘ

Counts the number of decimal digits.

For more complex needs check the Int base methods.

§Examples
assert_eq![1, Ascii(0_u64).count_digits()];
assert_eq![4, Ascii(9876_u64).count_digits()];
Source

pub const fn digits(self) -> [u8; 20]

Converts a u64 into a byte array of 20 ascii digits with leading zeros.

You can trim the leading zeros with trim_leading_bytes.

Source

pub const fn digits_str(self, width: u8) -> StringU8<20>

Available on crate feature string_u8 only.

Returns a static string with zero-padded digits with minimum width.

The given width will be clamped betweeen the actual number of digits and the maximum number of digits.

§Features
  • Will only be const if the _cmp_u8 feature is enabled.
  • Makes use of the unsafe_str feature if enabled.
Source§

impl Ascii<u128>

Source

pub const MAX_DIGITS: usize = 30usize

The maximum number of decimal digits a u128 can represent.

Source

pub const fn calc_digit(self, divisor: u128) -> u8 ⓘ

Returns the ASCII byte of a specific digit in a u128 number.

§Arguments
  • divisor: A power of 10 used to determine which digit to extract.
§Examples
assert_eq!(Ascii(12345_u128).calc_digit(10), b'4');
assert_eq!(Ascii(12345_u128).calc_digit(1000), b'2');
Source

pub const fn count_digits(self) -> u8 ⓘ

Counts the number of decimal digits.

For more complex needs check the Int base methods.

§Examples
assert_eq![1, Ascii(0_u128).count_digits()];
assert_eq![19, Ascii(9876543210987654321_u128).count_digits()];
Source

pub const fn digits(self) -> [u8; 39]

Converts a u128 into a byte array of 39 ascii digits with leading zeros.

You can trim the leading zeros with trim_leading_bytes.

Source

pub const fn digits_str(self, width: u8) -> StringU8<39>

Available on crate feature string_u8 only.

Returns a static string with zero-padded digits with minimum width.

The given width will be clamped betweeen the actual number of digits and the maximum number of digits.

§Features
  • Will only be const if the _cmp_u8 feature is enabled.
  • Makes use of the unsafe_str feature if enabled.

Trait Implementations§

Source§

impl<T: Clone + Copy> Clone for Ascii<T>

Source§

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

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T: Copy + Copy> Copy for Ascii<T>

Auto Trait Implementations§

§

impl<T> Freeze for Ascii<T>
where T: Freeze,

§

impl<T> RefUnwindSafe for Ascii<T>
where T: RefUnwindSafe,

§

impl<T> Send for Ascii<T>
where T: Send,

§

impl<T> Sync for Ascii<T>
where T: Sync,

§

impl<T> Unpin for Ascii<T>
where T: Unpin,

§

impl<T> UnwindSafe for Ascii<T>
where T: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
§

impl<T> ArchivePointee for T

§

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.
§

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> ByteSized for T

Source§

const BYTE_ALIGN: usize = _

The alignment of this type in bytes.
Source§

const BYTE_SIZE: usize = _

The size of this type in bytes.
Source§

fn byte_align(&self) -> usize ⓘ

Returns the alignment of this type in bytes.
Source§

fn byte_size(&self) -> usize ⓘ

Returns the size of this type in bytes. Read more
Source§

fn ptr_size_ratio(&self) -> [usize; 2]

Returns the size ratio between Ptr::BYTES and BYTE_SIZE. Read more
Source§

impl<T, R> Chain<R> for T
where T: ?Sized,

Source§

fn chain<F>(self, f: F) -> R
where F: FnOnce(Self) -> R, Self: Sized,

Chain a function which takes the parameter by value.
Source§

fn chain_ref<F>(&self, f: F) -> R
where F: FnOnce(&Self) -> R,

Chain a function which takes the parameter by shared reference.
Source§

fn chain_mut<F>(&mut self, f: F) -> R
where F: FnOnce(&mut Self) -> R,

Chain a function which takes the parameter by exclusive reference.
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
Source§

impl<T> ExtAny for T
where T: Any + ?Sized,

Source§

fn type_id() -> TypeId

Returns the TypeId of Self. Read more
Source§

fn type_of(&self) -> TypeId

Returns the TypeId of self. Read more
Source§

fn type_name(&self) -> &'static str ⓘ

Returns the type name of self. Read more
Source§

fn type_is<T: 'static>(&self) -> bool

Returns true if Self is of type T. Read more
Source§

fn as_any_ref(&self) -> &dyn Any
where Self: Sized,

Upcasts &self as &dyn Any. Read more
Source§

fn as_any_mut(&mut self) -> &mut dyn Any
where Self: Sized,

Upcasts &mut self as &mut dyn Any. Read more
Source§

fn as_any_box(self: Box<Self>) -> Box<dyn Any>
where Self: Sized,

Upcasts Box<self> as Box<dyn Any>. Read more
Source§

fn downcast_ref<T: 'static>(&self) -> Option<&T> ⓘ

Available on crate feature unsafe_layout only.
Returns some shared reference to the inner value if it is of type T. Read more
Source§

fn downcast_mut<T: 'static>(&mut self) -> Option<&mut T> ⓘ

Available on crate feature unsafe_layout only.
Returns some exclusive reference to the inner value if it is of type T. Read more
Source§

impl<T> ExtMem for T
where T: ?Sized,

Source§

const NEEDS_DROP: bool = _

Know whether dropping values of this type matters, in compile-time.
Source§

fn mem_align_of<T>() -> usize ⓘ

Returns the minimum alignment of the type in bytes. Read more
Source§

fn mem_align_of_val(&self) -> usize ⓘ

Returns the alignment of the pointed-to value in bytes. Read more
Source§

fn mem_size_of<T>() -> usize ⓘ

Returns the size of a type in bytes. Read more
Source§

fn mem_size_of_val(&self) -> usize ⓘ

Returns the size of the pointed-to value in bytes. Read more
Source§

fn mem_copy(&self) -> Self
where Self: Copy,

Bitwise-copies a value. Read more
Source§

fn mem_needs_drop(&self) -> bool

Returns true if dropping values of this type matters. Read more
Source§

fn mem_drop(self)
where Self: Sized,

Drops self by running its destructor. Read more
Source§

fn mem_forget(self)
where Self: Sized,

Forgets about self without running its destructor. Read more
Source§

fn mem_replace(&mut self, other: Self) -> Self
where Self: Sized,

Replaces self with other, returning the previous value of self. Read more
Source§

fn mem_take(&mut self) -> Self
where Self: Default,

Replaces self with its default value, returning the previous value of self. Read more
Source§

fn mem_swap(&mut self, other: &mut Self)
where Self: Sized,

Swaps the value of self and other without deinitializing either one. Read more
Source§

unsafe fn mem_zeroed<T>() -> T

Available on crate feature unsafe_layout only.
Returns the value of type T represented by the all-zero byte-pattern. Read more
Source§

unsafe fn mem_transmute_copy<Src, Dst>(src: &Src) -> Dst

Available on crate feature unsafe_layout only.
Returns the value of type T represented by the all-zero byte-pattern. Read more
Source§

fn mem_as_bytes(&self) -> &[u8] ⓘ
where Self: Sync + Unpin,

Available on crate feature unsafe_slice only.
View a Sync + Unpin self as &[u8]. Read more
Source§

fn mem_as_bytes_mut(&mut self) -> &mut [u8] ⓘ
where Self: Sync + Unpin,

Available on crate feature unsafe_slice only.
View a Sync + Unpin self as &mut [u8]. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<S> FromSample<S> for S

§

fn from_sample_(s: S) -> S

Source§

impl<T> Hook for T

Source§

fn hook_ref<F>(self, f: F) -> Self
where F: FnOnce(&Self),

Applies a function which takes the parameter by shared reference, and then returns the (possibly) modified owned value. Read more
Source§

fn hook_mut<F>(self, f: F) -> Self
where F: FnOnce(&mut Self),

Applies a function which takes the parameter by exclusive reference, and then returns the (possibly) modified owned value. Read more
§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<F, T> IntoSample<T> for F
where T: FromSample<F>,

§

fn into_sample(self) -> T

§

impl<T> LayoutRaw for T

§

fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError> ⓘ

Returns the layout of the type.
§

impl<T, N1, N2> Niching<NichedOption<T, N1>> for N2
where T: SharedNiching<N1, N2>, N1: Niching<T>, N2: Niching<T>,

§

unsafe fn is_niched(niched: *const NichedOption<T, N1>) -> bool

Returns whether the given value has been niched. Read more
§

fn resolve_niched(out: Place<NichedOption<T, N1>>)

Writes data to out indicating that a T is niched.
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize ⓘ

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> Pointee for T

§

type Metadata = ()

The metadata type for pointers and references to this type.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
§

impl<T, U> ToSample<U> for T
where U: FromSample<T>,

§

fn to_sample_(self) -> U

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error> ⓘ

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error> ⓘ

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
§

impl<S, T> Duplex<S> for T
where T: FromSample<S> + ToSample<S>,

§

impl<T> Ungil for T
where T: Send,