devela::_dep::_std::fmt

Trait Octal

1.0.0 · Source

pub trait Octal {
    // Required method
    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error> ⓘ;
}

Available on crate feature std only.

Expand description

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!("{x:o}"), "52");
assert_eq!(format!("{x:#o}"), "0o52");

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

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: {l:o}"), "l as octal is: 11");

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

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

1.0.0 · Source§

impl Octal for i16

1.0.0 · Source§

impl Octal for i32

1.0.0 · Source§

impl Octal for i64

1.0.0 · Source§

impl Octal for i128

1.0.0 · Source§

impl Octal for isize

1.0.0 · Source§

impl Octal for u8

1.0.0 · Source§

impl Octal for u16

1.0.0 · Source§

impl Octal for u32

1.0.0 · Source§

impl Octal for u64

1.0.0 · Source§

impl Octal for u128

1.0.0 · Source§

impl Octal for usize

Source §

impl Octal for ExampleBitfield

Available on crate feature _bit_u8 and doc only.

Source §

impl Octal for ExampleBitfieldCustom

Available on crate feature _bit_u8 and doc only.

Source §

impl Octal for ExampleBitfieldExtra

Available on crate feature _bit_u8 and doc only.

Source §

impl Octal for ExampleEnumSet

Available on doc only.

§

impl<'t, T, F, U> Octal for OptionFmtOrElse<'t, T, F>
where T: Octal, F: Fn() -> U, U: Display,

Source §

impl<'t, T, U> Octal for OptionFmtOr<'t, T, U>
where T: Octal, U: Display,

1.0.0 · Source§

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

1.0.0 · Source§

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

1.28.0 · Source§

impl<T> Octal for NonZero<T>
where T: ZeroablePrimitive + Octal,

Source §

impl<T> Octal for OptionFmt<'_, T>
where T: Octal,

1.74.0 · Source§

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

1.11.0 · Source§

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

Source §

impl<T: Octal> Octal for Bitwise<T>

Source §

impl<T: Octal> Octal for Frac<T>

Source §

impl<T: Octal> Octal for Int<T>

Source §

impl<const V: i8> Octal for devela::_info::examples::niche::NonValueI8<V>

Available on doc only.

Source §

impl<const V: i8> Octal for devela::all::NonValueI8<V>

Source §

impl<const V: u8> Octal for NonValueU8<V>

Source §

Trait OctalCopy item path

§Examples

Required Methods§

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

§Errors

Implementors§

impl Octal for i8

impl Octal for i16

impl Octal for i32

impl Octal for i64

impl Octal for i128

impl Octal for isize

impl Octal for u8

impl Octal for u16

impl Octal for u32

impl Octal for u64

impl Octal for u128

impl Octal for usize

impl Octal for ExampleBitfield

impl Octal for ExampleBitfieldCustom

impl Octal for ExampleBitfieldExtra

impl Octal for ExampleEnumSet

impl Octal for m128

impl Octal for m128d

impl Octal for m128i

impl Octal for m256

impl Octal for m256d

impl Octal for m256i

impl Octal for char7

impl Octal for char8

impl Octal for char16

impl Octal for KeyEventState

impl Octal for KeyModifiers

impl Octal for KeyboardEnhancementFlags

impl Octal for BigInt

impl Octal for NonZeroI16_be

impl Octal for NonZeroI16_le

impl Octal for NonZeroI32_be

impl Octal for NonZeroI32_le

impl Octal for NonZeroI64_be

impl Octal for NonZeroI64_le

impl Octal for NonZeroI128_be

impl Octal for NonZeroI128_le

impl Octal for NonZeroU16_be

impl Octal for NonZeroU16_le

impl Octal for NonZeroU32_be

impl Octal for NonZeroU32_le

impl Octal for NonZeroU64_be

impl Octal for NonZeroU64_le

impl Octal for NonZeroU128_be

impl Octal for NonZeroU128_le

impl Octal for i16_be

impl Octal for i16_le

impl Octal for i32_be

impl Octal for i32_le

impl Octal for i64_be

impl Octal for i64_le

impl Octal for i128_be

impl Octal for i128_le

impl Octal for u16_be

impl Octal for u16_le

impl Octal for u32_be

impl Octal for u32_le

impl Octal for u64_be

impl Octal for u64_le

impl Octal for u128_be

impl Octal for u128_le

impl Octal for NonZeroI16_ube

impl Octal for NonZeroI16_ule

impl Octal for NonZeroI32_ube

impl Octal for NonZeroI32_ule

impl Octal for NonZeroI64_ube

impl Octal for NonZeroI64_ule

impl Octal for NonZeroI128_ube

impl Octal for NonZeroI128_ule

impl Octal for NonZeroU16_ube

impl Octal for NonZeroU16_ule

impl Octal for NonZeroU32_ube

impl Octal for NonZeroU32_ule

impl Octal for NonZeroU64_ube

Trait Octal