Trait alloc::fmt::UpperHex

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

X formatting.

The UpperHex trait should format its output as a number in hexadecimal, with A through F in upper 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 UpperHex on a type:

use std::fmt;

struct Length(i32);

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

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

let l = Length(i32::MAX);

assert_eq!(format!("l as hex is: {l:X}"), "l as hex is: 7FFFFFFF");

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

Required Methods

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

Formats the value using the given formatter.

Implementations on Foreign Types

impl UpperHex for i64

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

impl<T, const LANES: usize> UpperHex for Simd<T, LANES> where
    T: SimdElement + UpperHex,
    LaneCount<LANES>: SupportedLaneCount, 

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

impl UpperHex for u64

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

impl UpperHex for NonZeroI16

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

impl UpperHex for NonZeroI128

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

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

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

impl UpperHex for u32

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

impl UpperHex for usize

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

impl<'_, T> UpperHex for &'_ mut T where
    T: UpperHex + ?Sized, 

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

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

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

impl UpperHex for NonZeroU32

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

impl UpperHex for u128

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

impl UpperHex for i8

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

impl UpperHex for NonZeroUsize

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

impl UpperHex for i32

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

impl UpperHex for NonZeroU128

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

impl UpperHex for NonZeroU8

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

impl UpperHex for NonZeroI8

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

impl<'_, T> UpperHex for &'_ T where
    T: UpperHex + ?Sized, 

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

impl UpperHex for NonZeroIsize

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

impl UpperHex for u16

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

impl UpperHex for isize

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

impl UpperHex for i128

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

impl UpperHex for NonZeroI32

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

impl UpperHex for NonZeroU64

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

impl UpperHex for i16

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

impl UpperHex for NonZeroU16

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

impl UpperHex for NonZeroI64

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

impl UpperHex for u8

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

Implementors