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 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: {l:X}"), "l as hex is: 7FFFFFFF");
assert_eq!(format!("l as hex is: {l:#010X}"), "l as hex is: 0x7FFFFFFF");
Required Methods§
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 CollisionGroup
impl UpperHex for SolverGroup
impl UpperHex for ActiveCollisionTypes
impl UpperHex for ActiveEvents
impl UpperHex for ActiveHooks
impl UpperHex for ColliderChanges
impl UpperHex for CollisionEventFlags
impl UpperHex for DebugRenderMode
impl UpperHex for Group
impl UpperHex for JointAxesMask
impl UpperHex for LockedAxes
impl UpperHex for QueryFilterFlags
impl UpperHex for RigidBodyChanges
impl UpperHex for SolverFlags
impl UpperHex for TriMeshFlags
impl UpperHex for NonZeroI8
impl UpperHex for NonZeroI16
impl UpperHex for NonZeroI32
impl UpperHex for NonZeroI64
impl UpperHex for NonZeroI128
impl UpperHex for NonZeroIsize
impl UpperHex for NonZeroU8
impl UpperHex for NonZeroU16
impl UpperHex for NonZeroU32
impl UpperHex for NonZeroU64
impl UpperHex for NonZeroU128
impl UpperHex for NonZeroUsize
impl UpperHex for BigInt
impl UpperHex for BigUint
impl UpperHex for Braced
impl UpperHex for Hyphenated
impl UpperHex for Simple
impl UpperHex for Urn
impl UpperHex for Uuid
impl UpperHex for Access
impl UpperHex for AccessFlags
impl UpperHex for AllocationFlags
impl UpperHex for AtFlags
impl UpperHex for AtFlags
impl UpperHex for AttachmentOps
impl UpperHex for Backends
impl UpperHex for Barrier
impl UpperHex for BindGroupLayoutFlags
impl UpperHex for BufferUsages
impl UpperHex for BufferUses
impl UpperHex for Bytes
impl UpperHex for BytesMut
impl UpperHex for Capabilities
impl UpperHex for Channels
impl UpperHex for CloneFlags
impl UpperHex for ColorMaterialFlags
impl UpperHex for ColorWrites
impl UpperHex for CompressedImageFormats
impl UpperHex for CreateFlags
impl UpperHex for CreateFlags
impl UpperHex for DescriptorPoolCreateFlags
impl UpperHex for DescriptorSetLayoutCreateFlags
impl UpperHex for Digest
impl UpperHex for DownlevelFlags
impl UpperHex for DupFlags
impl UpperHex for EcdsaPublicKey
impl UpperHex for Ed25519PrivateKey
impl UpperHex for Ed25519PublicKey
impl UpperHex for EfdFlags
impl UpperHex for EpollCreateFlags
impl UpperHex for EpollFlags
impl UpperHex for EventFlags
impl UpperHex for EventMask
impl UpperHex for EventMask
impl UpperHex for EventfdFlags
impl UpperHex for FPFastMathMode
impl UpperHex for FallocateFlags
impl UpperHex for FallocateFlags
impl UpperHex for FdFlag
impl UpperHex for FdFlags
impl UpperHex for Features
impl UpperHex for Features
impl UpperHex for Flags
impl UpperHex for FormatAspects
impl UpperHex for FragmentShadingRate
impl UpperHex for FsFlags
impl UpperHex for FunctionControl
impl UpperHex for GlobalUse
impl UpperHex for HexDisplay<'_>
impl UpperHex for IFlags
impl UpperHex for ImageOperands
impl UpperHex for ImageTypeFlags
impl UpperHex for InstanceFlags
impl UpperHex for KernelProfilingInfo
impl UpperHex for LoopControl
impl UpperHex for MemFdCreateFlag
impl UpperHex for MemfdFlags
impl UpperHex for MemoryAccess
impl UpperHex for MemoryFlags
impl UpperHex for MemoryPropertyFlags
impl UpperHex for MemorySemantics
impl UpperHex for Mesh2dPipelineKey
impl UpperHex for MntFlags
impl UpperHex for Mode
impl UpperHex for Mode
impl UpperHex for ModifiersState
impl UpperHex for MountFlags
impl UpperHex for MountPropagationFlags
impl UpperHex for Mpint
impl UpperHex for MsFlags
impl UpperHex for NextHopFlags
impl UpperHex for OFlag
impl UpperHex for OFlags
impl UpperHex for PacketFlag
impl UpperHex for PipelineFlags
impl UpperHex for PipelineLayoutFlags
impl UpperHex for PipelineStatisticsTypes
impl UpperHex for PollFlags
impl UpperHex for PortCap
impl UpperHex for PortType
impl UpperHex for RayFlag
impl UpperHex for RayFlags
impl UpperHex for ReadWriteFlags
impl UpperHex for RecvFlags
impl UpperHex for Remove
impl UpperHex for RenameFlags
impl UpperHex for RenameFlags
impl UpperHex for ResolveFlags
impl UpperHex for RouteFlags
impl UpperHex for RuleFlags
impl UpperHex for SFlag
impl UpperHex for SaFlags
impl UpperHex for SealFlag
impl UpperHex for SealFlags
impl UpperHex for SelectionControl
impl UpperHex for SendFlags
impl UpperHex for SfdFlags
impl UpperHex for ShaderStages
impl UpperHex for ShaderStages
impl UpperHex for Signature
impl UpperHex for Signature
impl UpperHex for SockaddrXdpFlags
impl UpperHex for SocketFlags
impl UpperHex for SpritePipelineKey
impl UpperHex for StatVfsMountFlags
impl UpperHex for StatxFlags
impl UpperHex for StorageAccess
impl UpperHex for TextureFormatCapabilities
impl UpperHex for TextureFormatFeatureFlags
impl UpperHex for TextureUsages
impl UpperHex for TextureUses
impl UpperHex for Transformations
impl UpperHex for TypeFlags
impl UpperHex for UniformityRequirements
impl UpperHex for UnmountFlags
impl UpperHex for UsageFlags
impl UpperHex for ValidationFlags
impl UpperHex for WaitPidFlag
impl UpperHex for WatchFlags
impl UpperHex for WatchMask
impl UpperHex for WatchMask
impl UpperHex for WindowButtons
impl UpperHex for Workarounds
impl UpperHex for WriterFlags
impl UpperHex for WriterFlags
impl UpperHex for WriterFlags
impl UpperHex for XattrFlags
impl UpperHex for XdpDescOptions
impl UpperHex for XdpOptionsFlags
impl UpperHex for XdpRingFlags
impl UpperHex for XdpUmemRegFlags
impl UpperHex for f32x4
impl UpperHex for f32x8
impl UpperHex for f64x2
impl UpperHex for f64x4
impl UpperHex for i8x16
impl UpperHex for i8x32
impl UpperHex for i16x8
impl UpperHex for i16x16
impl UpperHex for i32x4
impl UpperHex for i32x8
impl UpperHex for i64x2
impl UpperHex for i64x4
impl UpperHex for m128
impl UpperHex for m128d
impl UpperHex for m128i
impl UpperHex for m256
impl UpperHex for m256d
impl UpperHex for m256i
impl UpperHex for u8x16
impl UpperHex for u16x8
impl UpperHex for u16x16
impl UpperHex for u32x4
impl UpperHex for u32x8
impl UpperHex for u64x2
impl UpperHex for u64x4
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<'s, T> UpperHex for SliceVec<'s, T>where
T: UpperHex,
impl<A> UpperHex for ArrayVec<A>where
A: Array,
<A as Array>::Item: UpperHex,
impl<A> UpperHex for TinyVec<A>where
A: Array,
<A as Array>::Item: UpperHex,
impl<A, O> UpperHex for BitArray<A, O>where
O: BitOrder,
A: BitViewSized,
impl<Size> UpperHex for EncodedPoint<Size>where
Size: ModulusSize,
impl<T> UpperHex for &T
impl<T> UpperHex for &mut T
impl<T> UpperHex for Complex<T>
impl<T> UpperHex for BitFmt<T>
impl<T> UpperHex for Saturating<T>where
T: UpperHex,
impl<T> UpperHex for Wrapping<T>where
T: UpperHex,
impl<T> UpperHex for Ratio<T>
impl<T> UpperHex for BitFlags<T>where
T: BitFlag,
<T as RawBitFlags>::Numeric: 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, 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.