Trait LowerHex

pub trait LowerHex {
    // Required method
    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>;
}

x formatting.

The LowerHex trait should format its output as a number in hexadecimal, with a through f in lower case.

For primitive signed integers (i8 to i128, and isize), negative values are formatted as the two’s complement representation.

The alternate flag, #, adds a 0x in front of the output.

For more information on formatters, see the module-level documentation.

Examples

Basic usage with i32:

let y = 42; // 42 is '2a' in hex

assert_eq!(format!("{y:x}"), "2a");
assert_eq!(format!("{y:#x}"), "0x2a");

assert_eq!(format!("{:x}", -16), "fffffff0");

Implementing LowerHex on a type:

use std::fmt;

struct Length(i32);

impl fmt::LowerHex for Length {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let val = self.0;

        fmt::LowerHex::fmt(&val, f) // delegate to i32's implementation
    }
}

let l = Length(9);

assert_eq!(format!("l as hex is: {l:x}"), "l as hex is: 9");

assert_eq!(format!("l as hex is: {l:#010x}"), "l as hex is: 0x00000009");

Required Methods

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

Formats the value using the given formatter.

Errors

This function should return Err if, and only if, the provided Formatter returns Err. String formatting is considered an infallible operation; this function only returns a Result because writing to the underlying stream might fail and it must provide a way to propagate the fact that an error has occurred back up the stack.

Implementors

impl LowerHex for i8

impl LowerHex for i16

impl LowerHex for i32

impl LowerHex for i64

impl LowerHex for i128

impl LowerHex for isize

impl LowerHex for u8

impl LowerHex for u16

impl LowerHex for u32

impl LowerHex for u64

impl LowerHex for u128

impl LowerHex for usize

impl LowerHex for Bytes

impl LowerHex for BytesMut

impl LowerHex for bf16

impl LowerHex for f16

impl LowerHex for BigInt

impl LowerHex for BigUint

impl LowerHex for CreateFlags

impl LowerHex for ReadFlags

impl LowerHex for WatchFlags

impl LowerHex for Access

impl LowerHex for AtFlags

impl LowerHex for FallocateFlags

impl LowerHex for MemfdFlags

impl LowerHex for Mode

impl LowerHex for OFlags

impl LowerHex for RenameFlags

impl LowerHex for ResolveFlags

impl LowerHex for SealFlags

impl LowerHex for StatVfsMountFlags

impl LowerHex for StatxFlags

impl LowerHex for DupFlags

impl LowerHex for FdFlags

impl LowerHex for ReadWriteFlags

impl LowerHex for MountFlags

impl LowerHex for MountPropagationFlags

impl LowerHex for UnmountFlags

impl LowerHex for IFlags

impl LowerHex for XattrFlags

impl LowerHex for Braced

impl LowerHex for Hyphenated

impl LowerHex for Simple

impl LowerHex for Urn

impl LowerHex for Uuid

impl<'a, I> LowerHex for itertools::format::Format<'a, I>

where I: Iterator, <I as Iterator>::Item: LowerHex,

impl<'a, I> LowerHex for itertools::format::Format<'a, I>

where I: Iterator, <I as Iterator>::Item: LowerHex,

impl<'a, I> LowerHex for itertools::format::Format<'a, I>

where I: Iterator, <I as Iterator>::Item: LowerHex,

impl<'s, T> LowerHex for SliceVec<'s, T>

where T: LowerHex,

impl<A> LowerHex for TinyVec<A>

where A: Array, <A as Array>::Item: LowerHex,

impl<A> LowerHex for ArrayVec<A>

where A: Array, <A as Array>::Item: LowerHex,

impl<A, S, D> LowerHex for ArrayBase<S, D>

where A: LowerHex, D: Dimension, S: Data<Elem = A>,

Format the array using LowerHex and apply the formatting parameters used to each element.

The array is shown in multiline style.

impl<O> LowerHex for I16<O>

where O: ByteOrder,

impl<O> LowerHex for I32<O>

where O: ByteOrder,

impl<O> LowerHex for I64<O>

where O: ByteOrder,

impl<O> LowerHex for I128<O>

where O: ByteOrder,

impl<O> LowerHex for U16<O>

where O: ByteOrder,

impl<O> LowerHex for U32<O>

where O: ByteOrder,

impl<O> LowerHex for U64<O>

where O: ByteOrder,

impl<O> LowerHex for U128<O>

where O: ByteOrder,

impl<T> LowerHex for &T

where T: LowerHex + ?Sized,

impl<T> LowerHex for &mut T

where T: LowerHex + ?Sized,

impl<T> LowerHex for NonZero<T>

where T: ZeroablePrimitive + LowerHex,

impl<T> LowerHex for Saturating<T>

where T: LowerHex,

impl<T> LowerHex for Wrapping<T>

where T: LowerHex,

impl<T> LowerHex for GenericArray<u8, T>

where T: ArrayLength<u8> + Add, <T as Add>::Output: ArrayLength<u8>,

impl<T> LowerHex for Complex<T>

where T: LowerHex + Num + PartialOrd + Clone,

impl<const MIN: i8, const MAX: i8> LowerHex for RangedI8<MIN, MAX>

impl<const MIN: i16, const MAX: i16> LowerHex for RangedI16<MIN, MAX>

impl<const MIN: i32, const MAX: i32> LowerHex for RangedI32<MIN, MAX>

impl<const MIN: i64, const MAX: i64> LowerHex for RangedI64<MIN, MAX>

impl<const MIN: i128, const MAX: i128> LowerHex for RangedI128<MIN, MAX>

impl<const MIN: isize, const MAX: isize> LowerHex for RangedIsize<MIN, MAX>

impl<const MIN: u8, const MAX: u8> LowerHex for RangedU8<MIN, MAX>

impl<const MIN: u16, const MAX: u16> LowerHex for RangedU16<MIN, MAX>

impl<const MIN: u32, const MAX: u32> LowerHex for RangedU32<MIN, MAX>

impl<const MIN: u64, const MAX: u64> LowerHex for RangedU64<MIN, MAX>

impl<const MIN: u128, const MAX: u128> LowerHex for RangedU128<MIN, MAX>

impl<const MIN: usize, const MAX: usize> LowerHex for RangedUsize<MIN, MAX>