Trait Binary

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

b formatting.

The Binary trait should format its output as a number in binary.

For primitive signed integers (i8 to i128, and isize), negative values are formatted as the two’s complement representation.

The alternate flag, #, adds a 0b 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 '101010' in binary

assert_eq!(format!("{x:b}"), "101010");
assert_eq!(format!("{x:#b}"), "0b101010");

assert_eq!(format!("{:b}", -16), "11111111111111111111111111110000");

Implementing Binary on a type:

use std::fmt;

struct Length(i32);

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

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

let l = Length(107);

assert_eq!(format!("l as binary is: {l:b}"), "l as binary is: 1101011");

assert_eq!(
    // Note that the `0b` prefix added by `#` is included in the total width, so we
    // need to add two to correctly display all 32 bits.
    format!("l as binary is: {l:#034b}"),
    "l as binary is: 0b00000000000000000000000001101011"
);

Required Methods

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 Binary for i8

impl Binary for i16

impl Binary for i32

impl Binary for i64

impl Binary for i128

impl Binary for isize

impl Binary for u8

impl Binary for u16

impl Binary for u32

impl Binary for u64

impl Binary for u128

impl Binary for usize

impl Binary for bf16

impl Binary for f16

impl Binary for BigInt

impl Binary for BigUint

impl Binary for CreateFlags

impl Binary for ReadFlags

impl Binary for WatchFlags

impl Binary for Access

impl Binary for AtFlags

impl Binary for FallocateFlags

impl Binary for MemfdFlags

impl Binary for Mode

impl Binary for OFlags

impl Binary for RenameFlags

impl Binary for ResolveFlags

impl Binary for SealFlags

impl Binary for StatVfsMountFlags

impl Binary for StatxFlags

impl Binary for DupFlags

impl Binary for FdFlags

impl Binary for ReadWriteFlags

impl Binary for MountFlags

impl Binary for MountPropagationFlags

impl Binary for UnmountFlags

impl Binary for IFlags

impl Binary for XattrFlags

impl<'a, I> Binary for itertools::format::Format<'a, I>

where I: Iterator, <I as Iterator>::Item: Binary,

impl<'a, I> Binary for itertools::format::Format<'a, I>

where I: Iterator, <I as Iterator>::Item: Binary,

impl<'a, I> Binary for itertools::format::Format<'a, I>

where I: Iterator, <I as Iterator>::Item: Binary,

impl<'s, T> Binary for SliceVec<'s, T>

where T: Binary,

impl<A> Binary for TinyVec<A>

where A: Array, <A as Array>::Item: Binary,

impl<A> Binary for ArrayVec<A>

where A: Array, <A as Array>::Item: Binary,

impl<A, S, D> Binary for ArrayBase<S, D>

where A: Binary, D: Dimension, S: Data<Elem = A>,

Format the array using Binary and apply the formatting parameters used to each element.

The array is shown in multiline style.

impl<O> Binary for I16<O>

where O: ByteOrder,

impl<O> Binary for I32<O>

where O: ByteOrder,

impl<O> Binary for I64<O>

where O: ByteOrder,

impl<O> Binary for I128<O>

where O: ByteOrder,

impl<O> Binary for U16<O>

where O: ByteOrder,

impl<O> Binary for U32<O>

where O: ByteOrder,

impl<O> Binary for U64<O>

where O: ByteOrder,

impl<O> Binary for U128<O>

where O: ByteOrder,

impl<T> Binary for &T

where T: Binary + ?Sized,

impl<T> Binary for &mut T

where T: Binary + ?Sized,

impl<T> Binary for NonZero<T>

where T: ZeroablePrimitive + Binary,

impl<T> Binary for Saturating<T>

where T: Binary,

impl<T> Binary for Wrapping<T>

where T: Binary,

impl<T> Binary for Complex<T>

where T: Binary + Num + PartialOrd + Clone,

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

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

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

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

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

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

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

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

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

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

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

impl<const MIN: usize, const MAX: usize> Binary for RangedUsize<MIN, MAX>