UpperHex in alloc::fmt - Rust
Description: `X` formatting.
Keywords: rust, rustlang, rust-lang, UpperHex

# Trait alloc::fmt::UpperHex
1.0.0[−][src]

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

Expand description

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

Run

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

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

Run

## Required methods

[src]

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

Formats the value using the given formatter.

## Implementations on Foreign Types

1.34.0[src]

### impl UpperHex for NonZeroIsize

[src]

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

1.34.0[src]

### impl UpperHex for NonZeroI32

[src]

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

1.34.0[src]

### impl UpperHex for NonZeroI64

[src]

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

1.28.0[src]

### impl UpperHex for NonZeroUsize

[src]

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

1.34.0[src]

### impl UpperHex for NonZeroI128

[src]

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

[src]

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

[src]

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

1.28.0[src]

### impl UpperHex for NonZeroU8

[src]

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

1.28.0[src]

### impl UpperHex for NonZeroU32

[src]

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

1.34.0[src]

### impl UpperHex for NonZeroI8

[src]

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

1.11.0[src]

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

[src]

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

1.28.0[src]

### impl UpperHex for NonZeroU128

[src]

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

1.28.0[src]

### impl UpperHex for NonZeroU16

[src]

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

1.34.0[src]

### impl UpperHex for NonZeroI16

[src]

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

1.28.0[src]

### impl UpperHex for NonZeroU64

[src]

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

## Implementors

[src]

### impl UpperHex for i8

[src]

### impl UpperHex for i16

[src]

### impl UpperHex for i32

[src]

### impl UpperHex for i64

[src]

### impl UpperHex for i128

[src]

### impl UpperHex for isize

[src]

### impl UpperHex for u8

[src]

### impl UpperHex for u16

[src]

### impl UpperHex for u32

[src]

### impl UpperHex for u64

[src]

### impl UpperHex for u128

[src]

### impl UpperHex for usize

[src]

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

[src]

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