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 · Sourcefn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>
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.
Implementors§
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 RelayFlags
impl UpperHex for BigInt
impl UpperHex for BigUint
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 Access
impl UpperHex for AtFlags
impl UpperHex for BeginFlags
impl UpperHex for Bytes
impl UpperHex for Bytes
impl UpperHex for BytesMut
impl UpperHex for CreateFlags
impl UpperHex for CreateFlags
impl UpperHex for DupFlags
impl UpperHex for EcdsaPublicKey
impl UpperHex for Ed25519PrivateKey
impl UpperHex for Ed25519PublicKey
impl UpperHex for EventFlags
impl UpperHex for EventMask
impl UpperHex for EventfdFlags
impl UpperHex for FallocateFlags
impl UpperHex for FdFlags
impl UpperHex for FloatingPointEmulationControl
impl UpperHex for FloatingPointExceptionMode
impl UpperHex for HexDisplay<'_>
impl UpperHex for IFlags
impl UpperHex for MembarrierQuery
impl UpperHex for MemfdFlags
impl UpperHex for Mode
impl UpperHex for MountFlags
impl UpperHex for MountPropagationFlags
impl UpperHex for Mpint
impl UpperHex for OFlags
impl UpperHex for PidfdFlags
impl UpperHex for PidfdGetfdFlags
impl UpperHex for PipeFlags
impl UpperHex for PollFlags
impl UpperHex for ReadFlags
impl UpperHex for ReadWriteFlags
impl UpperHex for RecvFlags
impl UpperHex for RenameFlags
impl UpperHex for ResolveFlags
impl UpperHex for SealFlags
impl UpperHex for SendFlags
impl UpperHex for Signature
impl UpperHex for Signature
impl UpperHex for Signature
impl UpperHex for Signature
impl UpperHex for SockaddrXdpFlags
impl UpperHex for SocketFlags
impl UpperHex for SpeculationFeatureControl
impl UpperHex for SpeculationFeatureState
impl UpperHex for SpliceFlags
impl UpperHex for StatVfsMountFlags
impl UpperHex for StatxFlags
impl UpperHex for TimerfdFlags
impl UpperHex for TimerfdTimerFlags
impl UpperHex for UnalignedAccessControl
impl UpperHex for UnmountFlags
impl UpperHex for WaitOptions
impl UpperHex for WaitidOptions
impl UpperHex for WatchFlags
impl UpperHex for WatchMask
impl UpperHex for XattrFlags
impl UpperHex for XdpDescOptions
impl UpperHex for XdpOptionsFlags
impl UpperHex for XdpRingFlags
impl UpperHex for XdpUmemRegFlags
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<'a, I> UpperHex for Format<'a, I>
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<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
impl<T> UpperHex for &mut T
impl<T> UpperHex for NonZero<T>where
T: ZeroablePrimitive + UpperHex,
impl<T> UpperHex for Saturating<T>where
T: UpperHex,
impl<T> UpperHex for Wrapping<T>where
T: UpperHex,
impl<T> UpperHex for BoxSensitive<T>where
T: UpperHex,
impl<T> UpperHex for FmtBinary<T>
impl<T> UpperHex for FmtDisplay<T>
impl<T> UpperHex for FmtList<T>
impl<T> UpperHex for FmtLowerExp<T>
impl<T> UpperHex for FmtLowerHex<T>
impl<T> UpperHex for FmtOctal<T>
impl<T> UpperHex for FmtPointer<T>
impl<T> UpperHex for FmtUpperExp<T>
impl<T> UpperHex for FmtUpperHex<T>where
T: UpperHex,
impl<T> UpperHex for GenericArray<u8, T>
impl<T> UpperHex for Sensitive<T>where
T: UpperHex,
impl<T, O> UpperHex for BitBox<T, O>where
O: BitOrder,
T: BitStore,
impl<T, O> UpperHex for BitSlice<T, O>where
T: BitStore,
O: BitOrder,
§Bit-Slice Rendering
This implementation prints the contents of a &BitSlice in one of binary,
octal, or hexadecimal. It is important to note that this does not render the
raw underlying memory! They render the semantically-ordered contents of the
bit-slice as numerals. This distinction matters if you use type parameters that
differ from those presumed by your debugger (which is usually <u8, Msb0>).
The output separates the T elements as individual list items, and renders each
element as a base- 2, 8, or 16 numeric string. When walking an element, the bits
traversed by the bit-slice are considered to be stored in
most-significant-bit-first ordering. This means that index [0] is the high bit
of the left-most digit, and index [n] is the low bit of the right-most digit,
in a given printed word.
In order to render according to expectations of the Arabic numeral system, an
element being transcribed is chunked into digits from the least-significant end
of its rendered form. This is most noticeable in octal, which will always have a
smaller ceiling on the left-most digit in a printed word, while the right-most
digit in that word is able to use the full 0 ..= 7 numeral range.
§Examples
use bitvec::prelude::*;
let data = [
0b000000_10u8,
// digits print LTR
0b10_001_101,
// significance is computed RTL
0b01_000000,
];
let bits = &data.view_bits::<Msb0>()[6 .. 18];
assert_eq!(format!("{:b}", bits), "[10, 10001101, 01]");
assert_eq!(format!("{:o}", bits), "[2, 215, 1]");
assert_eq!(format!("{:X}", bits), "[2, 8D, 1]");The {:#} format modifier causes the standard 0b, 0o, or 0x prefix to be
applied to each printed word. The other format specifiers are not interpreted by
this implementation, and apply to the entire rendered text, not to individual
words.