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");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");Required methods
Implementations on Foreign Types
impl<T, const LANES: usize> UpperHex for Simd<T, LANES> where
T: SimdElement + UpperHex,
LaneCount<LANES>: SupportedLaneCount,
impl<T, const LANES: usize> UpperHex for Simd<T, LANES> where
T: SimdElement + UpperHex,
LaneCount<LANES>: SupportedLaneCount,
Render the contents of a BitSlice in a numeric format.
These implementations render the bits of memory contained in a
BitSlice as one of the three numeric bases that the Rust format
system supports:
Binaryrenders each bit individually as0or1,Octalrenders clusters of three bits as the numbers0through7,- and
UpperHexandLowerHexrender clusters of four bits as the numbers0through9andAthroughF.
The formatters produce a “word” for each element T of memory. The
chunked formats (octal and hexadecimal) operate somewhat peculiarly:
they show the semantic value of the memory, as interpreted by the
ordering parameter’s implementation rather than the raw value of
memory you might observe with a debugger. In order to ease the
process of expanding numbers back into bits, each digit is grouped to
the right edge of the memory element. So, for example, the byte
0xFF would be rendered in as 0o377 rather than 0o773.
Rendered words are chunked by memory elements, rather than by as clean as possible a number of digits, in order to aid visualization of the slice’s place in memory.