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.
Dyn Compatibility§
This trait is dyn compatible.
In older versions of Rust, dyn compatibility was called "object safety".
Implementors§
impl UpperHex for Access
impl UpperHex for AccessControlOptions
impl UpperHex for AtFlags
impl UpperHex for AtFlags
impl UpperHex for Bytes
impl UpperHex for BytesMut
impl UpperHex for CloneFlags
impl UpperHex for CopyfileFlags
impl UpperHex for DupFlags
impl UpperHex for EventFlags
impl UpperHex for FallocateFlags
impl UpperHex for FdFlags
impl UpperHex for Flags
impl UpperHex for Flags
impl UpperHex for Gid
impl UpperHex for MapFlags
impl UpperHex for Mode
impl UpperHex for MprotectFlags
impl UpperHex for MsyncFlags
impl UpperHex for OFlags
impl UpperHex for OpCodeFlag
impl UpperHex for Pid
impl UpperHex for PollFlags
impl UpperHex for PosixSpawnFlags
impl UpperHex for ProcessEvents
impl UpperHex for ProtFlags
impl UpperHex for RecvFlags
impl UpperHex for RenameFlags
impl UpperHex for ReturnFlags
impl UpperHex for RevocationPolicy
impl UpperHex for SaFlags
impl UpperHex for SendFlags
impl UpperHex for SignedAttributes
impl UpperHex for SocketFlags
impl UpperHex for StatVfsMountFlags
impl UpperHex for TrustOptions
impl UpperHex for Uid
impl UpperHex for UserFlags
impl UpperHex for VnodeEvents
impl UpperHex for WaitIdOptions
impl UpperHex for WaitOptions
impl UpperHex for WaitPidFlag
impl UpperHex for XattrFlags
impl UpperHex for bf16
Available on non-SPIR-V only.
impl UpperHex for f16
Available on non-SPIR-V only.