Trait UpperHex

1.0.0 · Source

pub trait UpperHex {
    // Required method
    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 y = 42; // 42 is '2A' in hex

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

1.0.0 · Source

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

Formats the value using the given formatter.

§Errors

This function should return Err if, and only if, the provided Formatter returns Err. String formatting is considered an infallible operation; this function only returns a Result because writing to the underlying stream might fail and it must provide a way to propagate the fact that an error has occurred back up the stack.

UpperHex

Trait UpperHex Copy item path

§Examples

Required Methods§

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

§Errors

Implementors§

impl UpperHex for EcdsaPublicKey

impl UpperHex for i8

impl UpperHex for i16

impl UpperHex for i32

impl UpperHex for i64

impl UpperHex for i128

impl UpperHex for isize

impl UpperHex for u8

impl UpperHex for u16

impl UpperHex for u32

impl UpperHex for u64

impl UpperHex for u128

impl UpperHex for usize

impl UpperHex for u1

impl UpperHex for u2

impl UpperHex for u3

impl UpperHex for u4

impl UpperHex for u5

impl UpperHex for u6

impl UpperHex for u7

impl UpperHex for u24

impl UpperHex for u40

impl UpperHex for u48

impl UpperHex for u56

impl UpperHex for HexDisplay<'_>

impl UpperHex for bytes::bytes::Bytes

impl UpperHex for BytesMut

impl UpperHex for Limb

impl UpperHex for ed25519::Signature

impl UpperHex for EventMask

impl UpperHex for WatchMask

impl UpperHex for EventKindMask

impl UpperHex for BigInt

impl UpperHex for BigUint

impl UpperHex for BigNum

impl UpperHex for BigNumRef

impl UpperHex for CipherCtxFlags

impl UpperHex for CMSOptions

impl UpperHex for OcspFlag

impl UpperHex for Pkcs7Flags

impl UpperHex for ExtensionContext

impl UpperHex for ShutdownState

impl UpperHex for SslMode

impl UpperHex for SslOptions

impl UpperHex for SslSessionCacheMode

impl UpperHex for SslVerifyMode

impl UpperHex for X509CheckFlags

impl UpperHex for X509VerifyFlags

impl UpperHex for rsa::pkcs1v15::signature::Signature

impl UpperHex for rsa::pss::signature::Signature

impl UpperHex for rustix::backend::event::epoll::CreateFlags

impl UpperHex for EventFlags

impl UpperHex for PollFlags

impl UpperHex for EventfdFlags

impl UpperHex for rustix::backend::fs::inotify::CreateFlags

impl UpperHex for ReadFlags

impl UpperHex for WatchFlags

impl UpperHex for Access

impl UpperHex for AtFlags

impl UpperHex for FallocateFlags

impl UpperHex for MemfdFlags

impl UpperHex for Mode

impl UpperHex for OFlags

impl UpperHex for RenameFlags

impl UpperHex for ResolveFlags

impl UpperHex for SealFlags

impl UpperHex for StatVfsMountFlags

impl UpperHex for DupFlags

impl UpperHex for FdFlags

impl UpperHex for ReadWriteFlags

impl UpperHex for RecvFlags

impl UpperHex for ReturnFlags

impl UpperHex for SendFlags

Trait UpperHex

impl<'a, I> UpperHex for Format<'a, I>
where I: Iterator, <I as Iterator>::Item: UpperHex,

impl<'a, T, O> UpperHex for Domain<'a, Const, T, O>
where O: BitOrder, T: BitStore,

impl<A, O> UpperHex for BitArray<A, O>
where O: BitOrder, A: BitViewSized,

impl<C> UpperHex for ecdsa::Signature<C>
where C: PrimeCurve, <<C as Curve>::FieldBytesSize as Add>::Output: ArrayLength<u8>,

impl<C> UpperHex for NonZeroScalar<C>
where C: CurveArithmetic,

impl<C> UpperHex for ScalarPrimitive<C>
where C: Curve,

impl<O> UpperHex for I16<O>
where O: ByteOrder,

impl<O> UpperHex for I32<O>
where O: ByteOrder,

impl<O> UpperHex for I64<O>
where O: ByteOrder,

impl<O> UpperHex for I128<O>
where O: ByteOrder,

impl<O> UpperHex for Isize<O>
where O: ByteOrder,

impl<O> UpperHex for U16<O>
where O: ByteOrder,

impl<O> UpperHex for U32<O>
where O: ByteOrder,

impl<O> UpperHex for U64<O>
where O: ByteOrder,

impl<O> UpperHex for U128<O>
where O: ByteOrder,

impl<O> UpperHex for Usize<O>
where O: ByteOrder,

impl<Size> UpperHex for EncodedPoint<Size>
where Size: ModulusSize,

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

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

impl<T> UpperHex for crypto_bigint::non_zero::NonZero<T>
where T: UpperHex + Zero,

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

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

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

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

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

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