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

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 x = 42; // 42 is '2a' in hex

assert_eq!(format!("{x:x}"), "2a");
assert_eq!(format!("{x:#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§

source

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

Formats the value using the given formatter.

Implementors§

source§

impl LowerHex for i8

source§

impl LowerHex for i16

source§

impl LowerHex for i32

source§

impl LowerHex for i64

source§

impl LowerHex for i128

source§

impl LowerHex for isize

source§

impl LowerHex for u8

source§

impl LowerHex for u16

source§

impl LowerHex for u32

source§

impl LowerHex for u64

source§

impl LowerHex for u128

source§

impl LowerHex for usize

source§

impl LowerHex for AccessRights

source§

impl LowerHex for U128

source§

impl LowerHex for U256

source§

impl LowerHex for U512

source§

impl LowerHex for BigInt

source§

impl LowerHex for BigUint

source§

impl<O, T> LowerHex for BitSlice<O, T>
where O: BitOrder, T: BitStore,

Render the contents of a BitSlice in a numeric format.

These implementations render the bits of memory contained in a BitSlice as one of the three numeric bases that the Rust format system supports:

  • Binary renders each bit individually as 0 or 1,
  • Octal renders clusters of three bits as the numbers 0 through 7,
  • and UpperHex and LowerHex render clusters of four bits as the numbers 0 through 9 and A through F.

The formatters produce a “word” for each element T of memory. The chunked formats (octal and hexadecimal) operate somewhat peculiarly: they show the semantic value of the memory, as interpreted by the ordering parameter’s implementation rather than the raw value of memory you might observe with a debugger. In order to ease the process of expanding numbers back into bits, each digit is grouped to the right edge of the memory element. So, for example, the byte 0xFF would be rendered in as 0o377 rather than 0o773.

Rendered words are chunked by memory elements, rather than by as clean as possible a number of digits, in order to aid visualization of the slice’s place in memory.

source§

impl<O, V> LowerHex for BitArray<O, V>
where O: BitOrder, V: BitView,

source§

impl<T> LowerHex for Domain<'_, T>
where T: BitStore,

source§

impl<T> LowerHex for &T
where T: LowerHex + ?Sized,

source§

impl<T> LowerHex for &mut T
where T: LowerHex + ?Sized,

1.28.0 · source§

impl<T> LowerHex for NonZero<T>

1.74.0 · source§

impl<T> LowerHex for Saturating<T>
where T: LowerHex,

1.11.0 · source§

impl<T> LowerHex for Wrapping<T>
where T: LowerHex,

source§

impl<T> LowerHex for GenericArray<u8, T>
where T: ArrayLength<u8> + Add, <T as Add>::Output: ArrayLength<u8>,

source§

impl<T> LowerHex for HexFmt<T>
where T: AsRef<[u8]>,

source§

impl<T> LowerHex for HexList<T>
where T: Clone + IntoIterator, <T as IntoIterator>::Item: AsRef<[u8]>,

source§

impl<T> LowerHex for Complex<T>
where T: LowerHex + Num + PartialOrd + Clone,

source§

impl<T> LowerHex for Ratio<T>
where T: LowerHex + Clone + Integer,

source§

impl<T> LowerHex for FmtBinary<T>
where T: Binary + LowerHex,

source§

impl<T> LowerHex for FmtDisplay<T>
where T: Display + LowerHex,

source§

impl<T> LowerHex for FmtLowerExp<T>
where T: LowerExp + LowerHex,

source§

impl<T> LowerHex for FmtLowerHex<T>
where T: LowerHex,

source§

impl<T> LowerHex for FmtOctal<T>
where T: Octal + LowerHex,

source§

impl<T> LowerHex for FmtPointer<T>
where T: Pointer + LowerHex,

source§

impl<T> LowerHex for FmtUpperExp<T>
where T: UpperExp + LowerHex,

source§

impl<T> LowerHex for FmtUpperHex<T>
where T: UpperHex + LowerHex,