Trait core::fmt::Binary

1.0.0 · source ·
pub trait Binary {
    // Required method
    fn fmt(&self, f: &mut Formatter<'_>) -> Result;
}
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");
Run

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"
);
Run

Required Methods§

source

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

Formats the value using the given formatter.

Implementors§

source§

impl Binary for i8

source§

impl Binary for i16

source§

impl Binary for i32

source§

impl Binary for i64

source§

impl Binary for i128

source§

impl Binary for isize

source§

impl Binary for u8

source§

impl Binary for u16

source§

impl Binary for u32

source§

impl Binary for u64

source§

impl Binary for u128

source§

impl Binary for usize

1.34.0 · source§

impl Binary for NonZeroI8

1.34.0 · source§

impl Binary for NonZeroI16

1.34.0 · source§

impl Binary for NonZeroI32

1.34.0 · source§

impl Binary for NonZeroI64

1.34.0 · source§

impl Binary for NonZeroI128

1.34.0 · source§

impl Binary for NonZeroIsize

1.28.0 · source§

impl Binary for NonZeroU8

1.28.0 · source§

impl Binary for NonZeroU16

1.28.0 · source§

impl Binary for NonZeroU32

1.28.0 · source§

impl Binary for NonZeroU64

1.28.0 · source§

impl Binary for NonZeroU128

1.28.0 · source§

impl Binary for NonZeroUsize

1.74.0 · source§

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

1.11.0 · source§

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

source§

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

source§

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