Struct lexical_core::NumberFormatBuilder

pub struct NumberFormatBuilder { /* private fields */ }

Build number format from specifications.

Returns the format on calling build if it was able to compile the format, otherwise, returns None.

Fields

• digit_separator - Character to separate digits.
• mantissa_radix - Radix for mantissa digits.
• exponent_base - Base for the exponent.
• exponent_radix - Radix for the exponent digits.
• base_prefix - Optional character for the base prefix.
• base_suffix - Optional character for the base suffix.
• required_integer_digits - If digits are required before the decimal point.
• required_fraction_digits - If digits are required after the decimal point.
• required_exponent_digits - If digits are required after the exponent character.
• required_mantissa_digits - If at least 1 significant digit is required.
• no_positive_mantissa_sign - If positive sign before the mantissa is not allowed.
• required_mantissa_sign - If positive sign before the mantissa is required.
• no_exponent_notation - If exponent notation is not allowed.
• no_positive_exponent_sign - If positive sign before the exponent is not allowed.
• required_exponent_sign - If sign before the exponent is required.
• no_exponent_without_fraction - If exponent without fraction is not allowed.
• no_special - If special (non-finite) values are not allowed.
• case_sensitive_special - If special (non-finite) values are case-sensitive.
• no_integer_leading_zeros - If leading zeros before an integer are not allowed.
• no_float_leading_zeros - If leading zeros before a float are not allowed.
• required_exponent_notation - If exponent notation is required.
• case_sensitive_exponent - If exponent characters are case-sensitive.
• case_sensitive_base_prefix - If base prefixes are case-sensitive.
• case_sensitive_base_suffix - If base suffixes are case-sensitive.
• integer_internal_digit_separator - If digit separators are allowed between integer digits.
• fraction_internal_digit_separator - If digit separators are allowed between fraction digits.
• exponent_internal_digit_separator - If digit separators are allowed between exponent digits.
• integer_leading_digit_separator - If a digit separator is allowed before any integer digits.
• fraction_leading_digit_separator - If a digit separator is allowed before any fraction digits.
• exponent_leading_digit_separator - If a digit separator is allowed before any exponent digits.
• integer_trailing_digit_separator - If a digit separator is allowed after any integer digits.
• fraction_trailing_digit_separator - If a digit separator is allowed after any fraction digits.
• exponent_trailing_digit_separator - If a digit separator is allowed after any exponent digits.
• integer_consecutive_digit_separator - If multiple consecutive integer digit separators are allowed.
• fraction_consecutive_digit_separator - If multiple consecutive fraction digit separators are allowed.
• special_digit_separator - If any digit separators are allowed in special (non-finite) values.

Write Integer Fields

No fields are used for writing integers.

Parse Integer Fields

These fields are used for parsing integers:

• digit_separator
• mantissa_radix
• base_prefix
• base_suffix
• no_positive_mantissa_sign
• required_mantissa_sign
• no_integer_leading_zeros
• integer_internal_digit_separator
• integer_leading_digit_separator
• integer_trailing_digit_separator
• integer_consecutive_digit_separator

Write Float Fields

These fields are used for writing floats:

• mantissa_radix
• exponent_base
• exponent_radix
• no_positive_mantissa_sign
• required_mantissa_sign
• no_exponent_notation
• no_positive_exponent_sign
• required_exponent_sign
• required_exponent_notation

Parse Float Fields

These fields are used for parsing floats:

• digit_separator
• mantissa_radix
• exponent_base
• exponent_radix
• base_prefix
• base_suffix
• required_integer_digits
• required_fraction_digits
• required_exponent_digits
• no_positive_mantissa_sign
• required_mantissa_sign
• no_exponent_notation
• no_positive_exponent_sign
• required_exponent_sign
• no_exponent_without_fraction
• no_special
• case_sensitive_special
• no_integer_leading_zeros
• no_float_leading_zeros
• required_exponent_notation
• case_sensitive_exponent
• case_sensitive_base_prefix
• case_sensitive_base_suffix
• integer_internal_digit_separator
• fraction_internal_digit_separator
• exponent_internal_digit_separator
• integer_leading_digit_separator
• fraction_leading_digit_separator
• exponent_leading_digit_separator
• integer_trailing_digit_separator
• fraction_trailing_digit_separator
• exponent_trailing_digit_separator
• integer_consecutive_digit_separator
• fraction_consecutive_digit_separator
• special_digit_separator

Implementations

impl NumberFormatBuilder

pub const fn new() -> NumberFormatBuilder

Create new NumberFormatBuilder with default arguments.

pub const fn binary() -> u128

Create number format for standard, binary number.

pub const fn octal() -> u128

Create number format for standard, octal number.

pub const fn decimal() -> u128

Create number format for standard, decimal number.

pub const fn hexadecimal() -> u128

Create number format for standard, hexadecimal number.

pub const fn from_radix(radix: u8) -> u128

Create number format from radix.

pub const fn get_digit_separator(&self) -> Option<NonZeroU8>

Get the digit separator for the number format.

pub const fn get_mantissa_radix(&self) -> u8

Get the radix for mantissa digits.

pub const fn get_exponent_base(&self) -> Option<NonZeroU8>

Get the radix for the exponent.

pub const fn get_exponent_radix(&self) -> Option<NonZeroU8>

Get the radix for exponent digits.

pub const fn get_base_prefix(&self) -> Option<NonZeroU8>

Get the optional character for the base prefix.

pub const fn get_base_suffix(&self) -> Option<NonZeroU8>

Get the optional character for the base suffix.

pub const fn get_required_integer_digits(&self) -> bool

Get if digits are required before the decimal point.

pub const fn get_required_fraction_digits(&self) -> bool

Get if digits are required after the decimal point.

pub const fn get_required_exponent_digits(&self) -> bool

Get if digits are required after the exponent character.

pub const fn get_required_mantissa_digits(&self) -> bool

Get if at least 1 significant digit is required.

pub const fn get_no_positive_mantissa_sign(&self) -> bool

Get if a positive sign before the mantissa is not allowed.

pub const fn get_required_mantissa_sign(&self) -> bool

Get if a sign symbol before the mantissa is required.

pub const fn get_no_exponent_notation(&self) -> bool

Get if exponent notation is not allowed.

pub const fn get_no_positive_exponent_sign(&self) -> bool

Get if a positive sign before the exponent is not allowed.

pub const fn get_required_exponent_sign(&self) -> bool

Get if a sign symbol before the exponent is required.

pub const fn get_no_exponent_without_fraction(&self) -> bool

Get if an exponent without fraction is not allowed.

pub const fn get_no_special(&self) -> bool

Get if special (non-finite) values are not allowed.

pub const fn get_case_sensitive_special(&self) -> bool

Get if special (non-finite) values are case-sensitive.

pub const fn get_no_integer_leading_zeros(&self) -> bool

Get if leading zeros before an integer are not allowed.

pub const fn get_no_float_leading_zeros(&self) -> bool

Get if leading zeros before a float are not allowed.

pub const fn get_required_exponent_notation(&self) -> bool

Get if exponent notation is required.

pub const fn get_case_sensitive_exponent(&self) -> bool

Get if exponent characters are case-sensitive.

pub const fn get_case_sensitive_base_prefix(&self) -> bool

Get if base prefixes are case-sensitive.

pub const fn get_case_sensitive_base_suffix(&self) -> bool

Get if base suffixes are case-sensitive.

pub const fn get_integer_internal_digit_separator(&self) -> bool

Get if digit separators are allowed between integer digits.

pub const fn get_fraction_internal_digit_separator(&self) -> bool

Get if digit separators are allowed between fraction digits.

pub const fn get_exponent_internal_digit_separator(&self) -> bool

Get if digit separators are allowed between exponent digits.

pub const fn get_integer_leading_digit_separator(&self) -> bool

Get if a digit separator is allowed before any integer digits.

pub const fn get_fraction_leading_digit_separator(&self) -> bool

Get if a digit separator is allowed before any fraction digits.

pub const fn get_exponent_leading_digit_separator(&self) -> bool

Get if a digit separator is allowed before any exponent digits.

pub const fn get_integer_trailing_digit_separator(&self) -> bool

Get if a digit separator is allowed after any integer digits.

pub const fn get_fraction_trailing_digit_separator(&self) -> bool

Get if a digit separator is allowed after any fraction digits.

pub const fn get_exponent_trailing_digit_separator(&self) -> bool

Get if a digit separator is allowed after any exponent digits.

pub const fn get_integer_consecutive_digit_separator(&self) -> bool

Get if multiple consecutive integer digit separators are allowed.

pub const fn get_fraction_consecutive_digit_separator(&self) -> bool

Get if multiple consecutive fraction digit separators are allowed.

pub const fn get_exponent_consecutive_digit_separator(&self) -> bool

Get if multiple consecutive exponent digit separators are allowed.

pub const fn get_special_digit_separator(&self) -> bool

Get if any digit separators are allowed in special (non-finite) values.

pub const fn digit_separator(
    self,
    character: Option<NonZeroU8>
) -> NumberFormatBuilder

Set the digit separator for the number format.

pub const fn radix(self, radix: u8) -> NumberFormatBuilder

Alias for mantissa radix.

pub const fn mantissa_radix(self, radix: u8) -> NumberFormatBuilder

Set the radix for mantissa digits.

pub const fn exponent_base(self, base: Option<NonZeroU8>) -> NumberFormatBuilder

Set the radix for the exponent.

pub const fn exponent_radix(
    self,
    radix: Option<NonZeroU8>
) -> NumberFormatBuilder

Set the radix for exponent digits.

pub const fn base_prefix(
    self,
    base_prefix: Option<NonZeroU8>
) -> NumberFormatBuilder

Set the optional character for the base prefix.

pub const fn base_suffix(
    self,
    base_suffix: Option<NonZeroU8>
) -> NumberFormatBuilder

Set the optional character for the base suffix.

pub const fn required_integer_digits(self, flag: bool) -> NumberFormatBuilder

Set if digits are required before the decimal point.

pub const fn required_fraction_digits(self, flag: bool) -> NumberFormatBuilder

Set if digits are required after the decimal point.

pub const fn required_exponent_digits(self, flag: bool) -> NumberFormatBuilder

Set if digits are required after the exponent character.

pub const fn required_mantissa_digits(self, flag: bool) -> NumberFormatBuilder

Set if at least 1 significant digit is required.

pub const fn required_digits(self, flag: bool) -> NumberFormatBuilder

Set if digits are required for all float components.

pub const fn no_positive_mantissa_sign(self, flag: bool) -> NumberFormatBuilder

Set if a positive sign before the mantissa is not allowed.

pub const fn required_mantissa_sign(self, flag: bool) -> NumberFormatBuilder

Set if a sign symbol before the mantissa is required.

pub const fn no_exponent_notation(self, flag: bool) -> NumberFormatBuilder

Set if exponent notation is not allowed.

pub const fn no_positive_exponent_sign(self, flag: bool) -> NumberFormatBuilder

Set if a positive sign before the exponent is not allowed.

pub const fn required_exponent_sign(self, flag: bool) -> NumberFormatBuilder

Set if a sign symbol before the exponent is required.

pub const fn no_exponent_without_fraction(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if an exponent without fraction is not allowed.

pub const fn no_special(self, flag: bool) -> NumberFormatBuilder

Set if special (non-finite) values are not allowed.

pub const fn case_sensitive_special(self, flag: bool) -> NumberFormatBuilder

Set if special (non-finite) values are case-sensitive.

pub const fn no_integer_leading_zeros(self, flag: bool) -> NumberFormatBuilder

Set if leading zeros before an integer are not allowed.

pub const fn no_float_leading_zeros(self, flag: bool) -> NumberFormatBuilder

Set if leading zeros before a float are not allowed.

pub const fn required_exponent_notation(self, flag: bool) -> NumberFormatBuilder

Set if exponent notation is required.

pub const fn case_sensitive_exponent(self, flag: bool) -> NumberFormatBuilder

Set if exponent characters are case-sensitive.

pub const fn case_sensitive_base_prefix(self, flag: bool) -> NumberFormatBuilder

Set if base prefixes are case-sensitive.

pub const fn case_sensitive_base_suffix(self, flag: bool) -> NumberFormatBuilder

Set if base suffixes are case-sensitive.

pub const fn integer_internal_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if digit separators are allowed between integer digits.

pub const fn fraction_internal_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if digit separators are allowed between fraction digits.

pub const fn exponent_internal_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if digit separators are allowed between exponent digits.

pub const fn internal_digit_separator(self, flag: bool) -> NumberFormatBuilder

Set all internal digit separator flags.

pub const fn integer_leading_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if a digit separator is allowed before any integer digits.

pub const fn fraction_leading_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if a digit separator is allowed before any fraction digits.

pub const fn exponent_leading_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if a digit separator is allowed before any exponent digits.

pub const fn leading_digit_separator(self, flag: bool) -> NumberFormatBuilder

Set all leading digit separator flags.

pub const fn integer_trailing_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if a digit separator is allowed after any integer digits.

pub const fn fraction_trailing_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if a digit separator is allowed after any fraction digits.

pub const fn exponent_trailing_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if a digit separator is allowed after any exponent digits.

pub const fn trailing_digit_separator(self, flag: bool) -> NumberFormatBuilder

Set all trailing digit separator flags.

pub const fn integer_consecutive_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if multiple consecutive integer digit separators are allowed.

pub const fn fraction_consecutive_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if multiple consecutive fraction digit separators are allowed.

pub const fn exponent_consecutive_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set if multiple consecutive exponent digit separators are allowed.

pub const fn consecutive_digit_separator(
    self,
    flag: bool
) -> NumberFormatBuilder

Set all consecutive digit separator flags.

pub const fn special_digit_separator(self, flag: bool) -> NumberFormatBuilder

Set if any digit separators are allowed in special (non-finite) values.

pub const fn digit_separator_flags(self, flag: bool) -> NumberFormatBuilder

Set all digit separator flag masks.

pub const fn integer_digit_separator_flags(
    self,
    flag: bool
) -> NumberFormatBuilder

Set all integer digit separator flag masks.

pub const fn fraction_digit_separator_flags(
    self,
    flag: bool
) -> NumberFormatBuilder

Set all fraction digit separator flag masks.

pub const fn exponent_digit_separator_flags(
    self,
    flag: bool
) -> NumberFormatBuilder

Set all exponent digit separator flag masks.

pub const fn build(&self) -> u128

Create 128-bit, packed number format struct from builder options.

NOTE: This function will never fail, due to issues with panicking (and therefore unwrapping Errors/Options) in const fns. It is therefore up to you to ensure the format is valid, called via the is_valid function on NumberFormat.

pub const fn rebuild(format: u128) -> NumberFormatBuilder

Re-create builder from format.

Trait Implementations

impl Default for NumberFormatBuilder

fn default() -> NumberFormatBuilder

Returns the “default value” for a type.