Trait std::fmt::LowerHex

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

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

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

1.34.0 · source§

impl LowerHex for NonZeroI8

1.34.0 · source§

impl LowerHex for NonZeroI16

1.34.0 · source§

impl LowerHex for NonZeroI32

1.34.0 · source§

impl LowerHex for NonZeroI64

1.34.0 · source§

impl LowerHex for NonZeroI128

1.34.0 · source§

impl LowerHex for NonZeroIsize

1.28.0 · source§

impl LowerHex for NonZeroU8

1.28.0 · source§

impl LowerHex for NonZeroU16

1.28.0 · source§

impl LowerHex for NonZeroU32

1.28.0 · source§

impl LowerHex for NonZeroU64

1.28.0 · source§

impl LowerHex for NonZeroU128

1.28.0 · source§

impl LowerHex for NonZeroUsize

source§

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

source§

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

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,