Struct const_format::fmt::FormattingFlags

pub struct FormattingFlags { /* private fields */ }

Available on crate feature fmt only.

This type bundles configuration for how to format data into strings, including.

Number formatting

How numbers are formatted in debug formatters, It can be accessed with the num_fmt method, and set with the set_num_fmt method.

Each type of number formatting corresponds to a NumberFormatting variant:

• NumberFormatting::Decimal (eg: formatc!("{:?}", FOO)): formats numbers as decimal.

• NumberFormatting::Hexadecimal (eg: formatc!("{:x}", FOO)): formats numbers as hexadecimal.

• NumberFormatting::Binary (eg: formatc!("{:b}", FOO)): formats numbers as binary.

Hexadecimal or binary formatting in the formatting string from this crate imply debug formatting, and can be used to for example print an array of binary numbers.

Note: Lowercase hexadecimal formatting requires calling the set_lower_hexadecimal method.

Alternate flag

A flag that types can use to be formatted differently when it’s enabled, checked with the .is_alternate() method.

The default behavior when it is enabled is this:

• The Debug formater (eg: formatc!("{:#?}", FOO)): pretty print structs and enums.

• The hexadecimal formater (eg: formatc!("{:#x}", FOO)): prefixes numbers with 0x.

• The binary formater (eg: formatc!("{:#b}", FOO)): prefixes numbers with 0b.`

Implementations

impl FormattingFlags

pub const NEW: Self = _

Constructs a FormattingFlags with these values:

• number formatting: NumberFormatting::Decimal

• is alternate: false

pub const fn new() -> Self

Constructs a FormattingFlags with these values:

• number formatting: NumberFormatting::Decimal

• is alternate: false

pub const fn set_num_fmt(self, num_fmt: NumberFormatting) -> Self

Sets the integer formatting,

This usually doesn’t affect the outputted text in display formatting.

pub const fn set_decimal(self) -> Self

Sets the number formatting to NumberFormatting::Decimal.

This means that numbers are written as decimal.

pub const fn set_hexadecimal(self) -> Self

Sets the number formatting to NumberFormatting::Hexadecimal.

This means that numbers are written as uppercase hexadecimal.

pub const fn set_lower_hexadecimal(self) -> Self

Sets the number formatting to NumberFormatting::Hexadecimal, and uses lowercase for alphabetic hexadecimal digits.

This means that numbers are written as lowercase hexadecimal.

pub const fn set_binary(self) -> Self

Sets the number formatting to NumberFormatting::Binary.

This means that numbers are written as binary.

pub const fn set_alternate(self, is_alternate: bool) -> Self

Sets whether the formatting flag is enabled.

pub const fn num_fmt(self) -> NumberFormatting

Gets the current NumberFormatting.

pub const fn is_alternate(self) -> bool

Gets whether the alternate flag is enabled

Trait Implementations

impl Clone for FormattingFlags

fn clone(&self) -> FormattingFlags

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FormattingFlags

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

Formats the value using the given formatter.

impl Copy for FormattingFlags