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

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

    pub trait Octal {
        fn fmt(&self, f: &mut Formatter) -> Result<(), Error>;
    }

`o` formatting.

The `Octal` trait should format its output as a number in base-8.

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

The alternate flag, `#`, adds a `0o` 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 '52' in octal

    assert_eq!(format!("{:o}", x), "52");
    assert_eq!(format!("{:#o}", x), "0o52");

    assert_eq!(format!("{:o}", -16), "37777777760");

Run

Implementing `Octal` on a type:

    use std::fmt;

    struct Length(i32);

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

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

    let l = Length(9);

    assert_eq!(format!("l as octal is: {:o}", l), "l as octal is: 11");

    assert_eq!(format!("l as octal is: {:#06o}", l), "l as octal is: 0o0011");

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 Octal for NonZeroIsize`[src]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Loading content...

## Implementors

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Loading content...