alloc::fmt::Binary - Rust
Description: API documentation for the Rust `Binary` trait in crate `alloc`.
Keywords: rust, rustlang, rust-lang, Binary

# 1.0.0[−][src]Trait alloc::fmt::Binary

    pub trait Binary {
        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!("{:b}", x), "101010");
    assert_eq!(format!("{:#b}", x), "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: {:b}", l), "l as binary is: 1101011");

    assert_eq!(
        format!("l as binary is: {:#032b}", l),
        "l as binary is: 0b000000000000000000000001101011"
    );

Run

## Required methods

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

Formats the value using the given formatter.

Loading content...

## Implementations on Foreign Types

### `impl Binary for NonZeroUsize`[src]

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

### `impl Binary for NonZeroU8`[src]

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

### `impl Binary for NonZeroI128`[src]

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

### `impl Binary for NonZeroU16`[src]

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

### `impl Binary for NonZeroU128`[src]

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

### `impl Binary for NonZeroU64`[src]

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

### `impl Binary for NonZeroU32`[src]

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

### `impl Binary for NonZeroIsize`[src]

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

### `impl Binary for NonZeroI32`[src]

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

### `impl Binary for NonZeroI16`[src]

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

### `impl Binary for NonZeroI64`[src]

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

### `impl Binary for NonZeroI8`[src]

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

### `impl<T> Binary for Wrapping<T> where
T: Binary,` [src]

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

Loading content...

## Implementors

### `impl Binary for i8`[src]

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

### `impl Binary for i16`[src]

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

### `impl Binary for i32`[src]

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

### `impl Binary for i64`[src]

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

### `impl Binary for i128`[src]

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

### `impl Binary for isize`[src]

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

### `impl Binary for u8`[src]

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

### `impl Binary for u16`[src]

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

### `impl Binary for u32`[src]

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

### `impl Binary for u64`[src]

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

### `impl Binary for u128`[src]

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

### `impl Binary for usize`[src]

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

### `impl<'_, T> Binary for &'_ T where
T: Binary + ?Sized,` [src]

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

### `impl<'_, T> Binary for &'_ mut T where
T: Binary + ?Sized,` [src]

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

Loading content...