Trait Binary

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

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ยง

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

1.0.0 ยท Sourceยง

impl Binary for i16

1.0.0 ยท Sourceยง

impl Binary for i32

1.0.0 ยท Sourceยง

impl Binary for i64

1.0.0 ยท Sourceยง

impl Binary for i128

1.0.0 ยท Sourceยง

impl Binary for isize

1.0.0 ยท Sourceยง

impl Binary for u8

1.0.0 ยท Sourceยง

impl Binary for u16

1.0.0 ยท Sourceยง

impl Binary for u32

1.0.0 ยท Sourceยง

impl Binary for u64

1.0.0 ยท Sourceยง

impl Binary for u128

1.0.0 ยท Sourceยง

impl Binary for usize

Sourceยง

impl Binary for nix::fcntl::AtFlags

Sourceยง

impl Binary for nix::fcntl::FallocateFlags

Sourceยง

impl Binary for FdFlag

Sourceยง

impl Binary for OFlag

Sourceยง

impl Binary for nix::fcntl::RenameFlags

Sourceยง

impl Binary for ResolveFlag

Sourceยง

impl Binary for SealFlag

Sourceยง

impl Binary for MemFdCreateFlag

Sourceยง

impl Binary for SaFlags

Sourceยง

impl Binary for SfdFlags

Sourceยง

impl Binary for nix::sys::stat::Mode

Sourceยง

impl Binary for SFlag

Sourceยง

impl Binary for FsFlags

Sourceยง

impl Binary for WaitPidFlag

Sourceยง

impl Binary for AccessFlags

Sourceยง

impl Binary for CreateFlags

Sourceยง

impl Binary for ReadFlags

Sourceยง

impl Binary for WatchFlags

Sourceยง

impl Binary for Access

Sourceยง

impl Binary for rustix::backend::fs::types::AtFlags

Sourceยง

impl Binary for rustix::backend::fs::types::FallocateFlags

Sourceยง

impl Binary for MemfdFlags

Sourceยง

impl Binary for rustix::backend::fs::types::Mode

Sourceยง

impl Binary for OFlags

Sourceยง

impl Binary for rustix::backend::fs::types::RenameFlags

Sourceยง

impl Binary for ResolveFlags

Sourceยง

impl Binary for SealFlags

Sourceยง

impl Binary for StatVfsMountFlags

Sourceยง

impl Binary for StatxFlags

Sourceยง

impl Binary for DupFlags

Sourceยง

impl Binary for FdFlags

Sourceยง

impl Binary for ReadWriteFlags

Sourceยง

impl Binary for MountFlags

Sourceยง

impl Binary for MountPropagationFlags

Sourceยง

impl Binary for UnmountFlags

Sourceยง

impl Binary for IFlags

Sourceยง

impl Binary for XattrFlags

Sourceยง

impl Binary for ControlModes

Sourceยง

impl Binary for InputModes

Sourceยง

impl Binary for LocalModes

Sourceยง

impl Binary for OutputModes

Sourceยง

impl<O> Binary for I16<O>
where O: ByteOrder,

Sourceยง

impl<O> Binary for I32<O>
where O: ByteOrder,

Sourceยง

impl<O> Binary for I64<O>
where O: ByteOrder,

Sourceยง

impl<O> Binary for I128<O>
where O: ByteOrder,

Sourceยง

impl<O> Binary for U16<O>
where O: ByteOrder,

Sourceยง

impl<O> Binary for U32<O>
where O: ByteOrder,

Sourceยง

impl<O> Binary for U64<O>
where O: ByteOrder,

Sourceยง

impl<O> Binary for U128<O>
where O: ByteOrder,

1.0.0 ยท Sourceยง

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

1.0.0 ยท Sourceยง

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

1.28.0 ยท Sourceยง

impl<T> Binary for NonZero<T>

1.74.0 ยท Sourceยง

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

1.11.0 ยท Sourceยง

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