Module std_tools::dependencies::strs_tools::string::number::protected::format
[−]Expand description
Public API for the number format packed struct.
This has a consistent API whether or not the format feature is
enabled, however, most functionality will be disabled if the feature
is not enabled.
Pre-Defined Formats
These are the pre-defined formats for parsing numbers from various programming, markup, and data languages.
Syntax Flags
Bitflags to get and set syntax flags for the format packed struct.
- REQUIRED_INTEGER_DIGITS
- REQUIRED_FRACTION_DIGITS
- REQUIRED_EXPONENT_DIGITS
- REQUIRED_MANTISSA_DIGITS
- REQUIRED_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
Digit Separator Flags
Bitflags to get and set digit separators flags for the format packed struct.
- 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
- EXPONENT_CONSECUTIVE_DIGIT_SEPARATOR
- INTERNAL_DIGIT_SEPARATOR
- LEADING_DIGIT_SEPARATOR
- TRAILING_DIGIT_SEPARATOR
- CONSECUTIVE_DIGIT_SEPARATOR
- SPECIAL_DIGIT_SEPARATOR
Character Shifts and Masks
Bitmasks and bitshifts to get and set control characters for the format packed struct.
- DIGIT_SEPARATOR_SHIFT
- DIGIT_SEPARATOR
- BASE_PREFIX_SHIFT
- BASE_PREFIX
- BASE_SUFFIX_SHIFT
- BASE_SUFFIX
- MANTISSA_RADIX_SHIFT
- MANTISSA_RADIX
- RADIX_SHIFT
- RADIX
- EXPONENT_BASE_SHIFT
- EXPONENT_BASE
- EXPONENT_RADIX_SHIFT
- EXPONENT_RADIX
Character Functions
Functions to get control characters from the format packed struct.
- digit_separator
- base_prefix
- base_suffix
- mantissa_radix
- exponent_base
- exponent_radix
- radix_from_flags
Validators
Functions to validate control characters for the format packed struct.
Structs
Build number format from specifications.
Constants
Mask to extract the base prefix character.
Shift to convert to and from a base prefix as a u8.
Mask to extract the base suffix character.
Shift to convert to and from a base suffix as a u8.
Base prefixes are case-sensitive.
Base suffixes are case-sensitive.
Exponent characters are case-sensitive.
Special (non-finite) values are case-sensitive.
Multiple consecutive digit separators are allowed.
Mask to extract the digit separator character.
Shift to convert to and from a digit separator as a u8.
Mask to extract the exponent base: the base the exponent is raised to.
Shift to convert to and from an exponent base as a u32.
Multiple consecutive exponent digit separators are allowed.
Digit separators are allowed between exponent digits.
A digit separator is allowed before any exponent digits.
Mask to extract the exponent radix: the radix for the exponent digits.
Shift to convert to and from an exponent radix as a u32.
A digit separator is allowed after any exponent digits.
Multiple consecutive fraction digit separators are allowed.
Digit separators are allowed between fraction digits.
A digit separator is allowed before any fraction digits.
A digit separator is allowed after any fraction digits.
Multiple consecutive integer digit separators are allowed.
Digit separators are allowed between integer digits.
A digit separator is allowed before any integer digits.
A digit separator is allowed after any integer digits.
Digit separators are allowed between digits.
A digit separator is allowed before any digits.
Mask to extract the mantissa radix: the radix for the significant digits.
Shift to convert to and from a mantissa radix as a u32.
Exponent notation is not allowed.
Exponent without a fraction component is not allowed.
Leading zeros before a float value are not allowed.
Leading zeros before an integer value are not allowed.
Positive sign before the exponent is not allowed.
Positive sign before the mantissa is not allowed.
Special (non-finite) values are not allowed.
Alias for MANTISSA_RADIX.
Alias for MANTISSA_RADIX_SHIFT.
At least 1 digit in the number is required.
Digits are required after the exponent character. This check will only occur if the exponent character is present.
Exponent notation is required.
Positive sign before the exponent is required.
Digits are required after the decimal point. This check will only occur if the decimal point is present.
Digits are required before the decimal point.
Mantissa digits are required (either before or after the decimal point).
Positive sign before the mantissa is required.
Any digit separators are allowed in special (non-finite) values.
Standard number format. This is identical to the Rust string format.
A digit separator is allowed after any digits.
Functions
Extract the base prefix character from the format packed struct.
Extract the base suffix character from the format packed struct.
Extract the digit separator from the format packed struct.
Extract the exponent base from the format packed struct.
If not provided, defaults to mantissa_radix.
Extract the exponent radix from the format packed struct.
If not provided, defaults to mantissa_radix.
Get the error type from the format packed struct.
Determine if the format packed struct is valid.
Determine if the base prefix character is valid.
Determine if the base suffix character is valid.
Determine if the digit separator is valid. Digit separators must not be valid digits or sign characters.
Determine if the provided exponent flags are valid.
Determine if all of the “punctuation” characters for the options API are valid.
Determine if all of the “punctuation” characters are valid.
Determine if the radix is valid.
Extract the mantissa radix from the format packed struct.
Extract a generic radix from the format and bitflags.
Type Definitions
Type with the exact same size as a u8.