Trait core::fmt::LowerHex

1.0.0· source · [−]

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

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");

Run

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: {:x}", l), "l as hex is: 9");

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