Trait xcm_emulator::fmt::LowerHex

1.0.0 · source ·

pub trait LowerHex {
    // Required method
    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>;
}

Expand description

x formatting.

The LowerHex trait should format its output as a number in hexadecimal, with a through f in lower 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 LowerHex on a type:

use std::fmt;

struct Length(i32);

impl fmt::LowerHex for Length {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let val = self.0;

        fmt::LowerHex::fmt(&val, f) // delegate to i32's implementation
    }
}

let l = Length(9);

assert_eq!(format!("l as hex is: {l:x}"), "l as hex is: 9");

assert_eq!(format!("l as hex is: {l:#010x}"), "l as hex is: 0x00000009");

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.

Implementors§

1.0.0 · source§

impl LowerHex for i8

1.0.0 · source§

impl LowerHex for i16

1.0.0 · source§

impl LowerHex for i32

1.0.0 · source§

impl LowerHex for i64

1.0.0 · source§

impl LowerHex for i128

1.0.0 · source§

impl LowerHex for isize

1.0.0 · source§

impl LowerHex for u8

1.0.0 · source§

impl LowerHex for u16

1.0.0 · source§

impl LowerHex for u32

1.0.0 · source§

impl LowerHex for u64

1.0.0 · source§

impl LowerHex for u128

1.0.0 · source§

impl<'a, I> LowerHex for itertools::format::Format<'a, I>
where I: Iterator, <I as Iterator>::Item: LowerHex,

source §

impl<'a, I> LowerHex for itertools::format::Format<'a, I>
where I: Iterator, <I as Iterator>::Item: LowerHex,

§

impl<'a, T> LowerHex for StyledValue<'a, T>
where T: LowerHex,

§

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

§

impl<'s, T> LowerHex for SliceVec<'s, T>
where T: LowerHex,

§

impl<A> LowerHex for ArrayVec<A>
where A: Array, <A as Array>::Item: LowerHex,

§

impl<A> LowerHex for TinyVec<A>
where A: Array, <A as Array>::Item: LowerHex,

§

impl<A, B> LowerHex for DisplayArray<A, B>
where A: Clone + IntoIterator, B: FixedLenBuf, <A as IntoIterator>::Item: Borrow<u8>,

§

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

§

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

§

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

§

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

§

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

1.0.0 · source§

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

1.0.0 · source§

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

1.28.0 · source§

impl<T> LowerHex for core::num::nonzero::NonZero<T>
where T: ZeroablePrimitive + LowerHex,

1.74.0 · source§

impl<T> LowerHex for Saturating<T>
where T: LowerHex,

1.11.0 · source§

impl<T> LowerHex for core::num::wrapping::Wrapping<T>
where T: LowerHex,

source §

impl<T> LowerHex for Complex<T>
where T: LowerHex + Num + PartialOrd + Clone,

source §

impl<T> LowerHex for Ratio<T>
where T: LowerHex + Clone + Integer,

§

impl<T> LowerHex for BitFlags<T>
where T: BitFlag, <T as RawBitFlags>::Numeric: LowerHex,

§

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

§

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

§

impl<T> LowerHex for FmtList<T>
where &'a T: for<'a> IntoIterator, <&'a T as IntoIterator>::Item: for<'a> LowerHex,

§

impl<T> LowerHex for FmtLowerExp<T>
where T: LowerExp + LowerHex,

§

impl<T> LowerHex for FmtLowerHex<T>
where T: LowerHex,

§

impl<T> LowerHex for FmtOctal<T>
where T: Octal + LowerHex,

§

impl<T> LowerHex for FmtPointer<T>
where T: Pointer + LowerHex,

§

impl<T> LowerHex for FmtUpperExp<T>
where T: UpperExp + LowerHex,

§

impl<T> LowerHex for FmtUpperHex<T>
where T: UpperHex + LowerHex,

§

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

§

impl<T> LowerHex for Hash<T>
where T: Tag,

§

impl<T> LowerHex for Hmac<T>
where T: Hash,

§

impl<T> LowerHex for NonZero<T>
where T: LowerHex + Zero,

§

impl<T> LowerHex for Wrapping<T>
where T: LowerHex,

§

impl<T, O> LowerHex for BitBox<T, O>
where O: BitOrder, T: BitStore,

§

impl<T, O> LowerHex 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.

§

impl<T, O> LowerHex for BitVec<T, O>
where O: BitOrder, T: BitStore,

source §

impl<T, R, C, S> LowerHex for Matrix<T, R, C, S>
where R: Dim, C: Dim, T: Scalar + LowerHex, S: RawStorage<T, R, C>,

§

impl<const LIMBS: usize> LowerHex for Uint<LIMBS>

§

impl<const MIN: i8, const MAX: i8> LowerHex for RangedI8<MIN, MAX>

§

impl<const MIN: i16, const MAX: i16> LowerHex for RangedI16<MIN, MAX>

§

impl<const MIN: i32, const MAX: i32> LowerHex for RangedI32<MIN, MAX>

§

impl<const MIN: i64, const MAX: i64> LowerHex for RangedI64<MIN, MAX>

§

impl<const MIN: i128, const MAX: i128> LowerHex for RangedI128<MIN, MAX>

§

impl<const MIN: isize, const MAX: isize> LowerHex for RangedIsize<MIN, MAX>

§

impl<const MIN: u8, const MAX: u8> LowerHex for RangedU8<MIN, MAX>

§

impl<const MIN: u16, const MAX: u16> LowerHex for RangedU16<MIN, MAX>

§

impl<const MIN: u32, const MAX: u32> LowerHex for RangedU32<MIN, MAX>

§

impl<const MIN: u64, const MAX: u64> LowerHex for RangedU64<MIN, MAX>

§

impl<const MIN: u128, const MAX: u128> LowerHex for RangedU128<MIN, MAX>

§

Trait xcm_emulator::fmt::LowerHexCopy item path

§Examples

Required Methods§

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

§Errors

Implementors§

impl LowerHex for i8

impl LowerHex for i16

impl LowerHex for i32

impl LowerHex for i64

impl LowerHex for i128

impl LowerHex for isize

impl LowerHex for u8

impl LowerHex for u16

impl LowerHex for u32

impl LowerHex for u64

impl LowerHex for u128

impl LowerHex for usize

impl LowerHex for BigInt

impl LowerHex for BigUint

impl LowerHex for Access

impl LowerHex for Access

impl LowerHex for Access

impl LowerHex for AtFlags

impl LowerHex for AtFlags

impl LowerHex for AtFlags

impl LowerHex for Bytes

impl LowerHex for BytesMut

impl LowerHex for Capabilities

impl LowerHex for ControlModes

impl LowerHex for CreateFlags

impl LowerHex for CreateFlags

impl LowerHex for CreateFlags

impl LowerHex for CreateFlags

impl LowerHex for DupFlags

impl LowerHex for DupFlags

impl LowerHex for DupFlags

impl LowerHex for ElligatorSwift

impl LowerHex for EventFlags

impl LowerHex for EventFlags

impl LowerHex for EventfdFlags

impl LowerHex for EventfdFlags

impl LowerHex for ExecutorParamsHash

impl LowerHex for ExecutorParamsPrepHash

impl LowerHex for FallocateFlags

impl LowerHex for FallocateFlags

impl LowerHex for FallocateFlags

impl LowerHex for FdFlags

impl LowerHex for FdFlags

impl LowerHex for FdFlags

impl LowerHex for FloatingPointEmulationControl

impl LowerHex for FloatingPointExceptionMode

impl LowerHex for H128

impl LowerHex for H128

impl LowerHex for H160

impl LowerHex for H160

impl LowerHex for H256

impl LowerHex for H256

impl LowerHex for H384

impl LowerHex for H384

impl LowerHex for H512

impl LowerHex for H512

impl LowerHex for H768

impl LowerHex for H768

impl LowerHex for Hash

impl LowerHex for Hash

impl LowerHex for Hash

impl LowerHex for Hash

impl LowerHex for Hash

impl LowerHex for Hash

impl LowerHex for Hash

impl LowerHex for Hash

impl LowerHex for HexDisplay<'_>

impl LowerHex for InputModes

impl LowerHex for Limb

impl LowerHex for LocalModes

impl LowerHex for MapFlags

impl LowerHex for MembarrierQuery

impl LowerHex for MemfdFlags

impl LowerHex for MemfdFlags

Trait xcm_emulator::fmt::LowerHex