# Trait alloc::fmt::Binary

1.0.0 · source · [−]

    pub trait Binary {
        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");

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!(
        format!("l as binary is: {l:#032b}"),
        "l as binary is: 0b000000000000000000000001101011"
    );

Run

## Required Methods

source

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

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

source

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

source

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

source

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

1.11.0 · source

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

source

### impl<T, const LANES: usize> Binary for Simd<T, LANES>where
LaneCount<LANES>: SupportedLaneCount,
T: SimdElement + Binary,