lexical_write_float

Module format

Source
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.

§Digit Separator Flags

Bitflags to get and set digit separators flags for the format packed struct.

§Character Shifts and Masks

Bitmasks and bitshifts to get and set control characters for the format packed struct.

§Character Functions

Functions to get control characters from the format packed struct.

§Validators

Functions to validate control characters for the format packed struct.

Structs§

NumberFormatBuilder
Build number format from specifications.

Constants§

BASE_PREFIX
Mask to extract the base prefix character.
BASE_PREFIX_SHIFT
Shift to convert to and from a base prefix as a u8.
BASE_SUFFIX
Mask to extract the base suffix character.
BASE_SUFFIX_SHIFT
Shift to convert to and from a base suffix as a u8.
C11_LITERAL
Number format for a C++98 literal floating-point number.
C11_STRING
Number format for a C++98 string floating-point number.
C18_LITERAL
Number format for a C++98 literal floating-point number.
C18_STRING
Number format for a C++98 string floating-point number.
C89_LITERAL
Number format for a C++98 literal floating-point number.
C89_STRING
Number format for a C++98 string floating-point number.
C90_LITERAL
Number format for a C++98 literal floating-point number.
C90_STRING
Number format for a C++98 string floating-point number.
C99_LITERAL
Number format for a C++98 literal floating-point number.
C99_STRING
Number format for a C++98 string floating-point number.
CASE_SENSITIVE_BASE_PREFIX
Base prefixes are case-sensitive.
CASE_SENSITIVE_BASE_SUFFIX
Base suffixes are case-sensitive.
CASE_SENSITIVE_EXPONENT
Exponent characters are case-sensitive.
CASE_SENSITIVE_SPECIAL
Special (non-finite) values are case-sensitive.
CLOJURE_LITERAL
Number format for a Clojure literal floating-point number.
CLOJURE_STRING
Number format to parse a Clojure float from string.
COBOL_LITERAL
Number format for a Cobol literal floating-point number.
COBOL_STRING
Number format to parse a Cobol float from string.
COFFEESCRIPT_LITERAL
Number format for a Coffeescript literal floating-point number.
COFFEESCRIPT_STRING
Number format to parse a Coffeescript float from string.
CONSECUTIVE_DIGIT_SEPARATOR
Multiple consecutive digit separators are allowed.
CSHARP1_LITERAL
Number format for a C#1 literal floating-point number.
CSHARP1_STRING
Number format to parse a C#1 float from string.
CSHARP2_LITERAL
Number format for a C#2 literal floating-point number.
CSHARP2_STRING
Number format to parse a C#2 float from string.
CSHARP3_LITERAL
Number format for a C#3 literal floating-point number.
CSHARP3_STRING
Number format to parse a C#3 float from string.
CSHARP4_LITERAL
Number format for a C#4 literal floating-point number.
CSHARP4_STRING
Number format to parse a C#4 float from string.
CSHARP5_LITERAL
Number format for a C#5 literal floating-point number.
CSHARP5_STRING
Number format to parse a C#5 float from string.
CSHARP6_LITERAL
Number format for a C#6 literal floating-point number.
CSHARP6_STRING
Number format to parse a C#6 float from string.
CSHARP7_LITERAL
Number format for a C#7 literal floating-point number.
CSHARP7_STRING
Number format to parse a C#7 float from string.
CSHARP_LITERAL
Number format for a C# literal floating-point number.
CSHARP_STRING
Number format to parse a C# float from string.
CXX03_LITERAL
Number format for a C++03 literal floating-point number.
CXX03_STRING
Number format for a C++03 string floating-point number.
CXX11_LITERAL
Number format for a C++11 literal floating-point number.
CXX11_STRING
Number format for a C++11 string floating-point number.
CXX14_LITERAL
Number format for a C++14 literal floating-point number.
CXX14_STRING
Number format for a C++14 string floating-point number.
CXX17_LITERAL
Number format for a C++17 literal floating-point number.
CXX17_STRING
Number format for a C++17 string floating-point number.
CXX20_LITERAL
Number format for a C++20 literal floating-point number.
CXX20_STRING
Number format for a C++20 string floating-point number.
CXX98_LITERAL
Number format for a C++98 literal floating-point number.
CXX98_STRING
Number format for a C++98 string floating-point number.
CXX_LITERAL
Number format for a C++ literal floating-point number.
CXX_STRING
Number format to parse a C++ float from string.
C_LITERAL
Number format for a C literal floating-point number.
C_STRING
Number format to parse a C float from string.
DIGIT_SEPARATOR
Mask to extract the digit separator character.
DIGIT_SEPARATOR_SHIFT
Shift to convert to and from a digit separator as a u8.
D_LITERAL
Number format for a D literal floating-point number.
D_STRING
Number format to parse a D float from string.
ELIXIR_LITERAL
Number format for an Elixir literal floating-point number.
ELIXIR_STRING
Number format to parse an Elixir float from string.
ELM_LITERAL
Number format for an Elm literal floating-point number.
ELM_STRING
Number format to parse an Elm float from string.
ERLANG_LITERAL
Number format for an Erlang literal floating-point number.
ERLANG_STRING
Number format to parse an Erlang float from string.
EXPONENT_BASE
Mask to extract the exponent base: the base the exponent is raised to.
EXPONENT_BASE_SHIFT
Shift to convert to and from an exponent base as a u32.
EXPONENT_CONSECUTIVE_DIGIT_SEPARATOR
Multiple consecutive exponent digit separators are allowed.
EXPONENT_INTERNAL_DIGIT_SEPARATOR
Digit separators are allowed between exponent digits.
EXPONENT_LEADING_DIGIT_SEPARATOR
A digit separator is allowed before any exponent digits.
EXPONENT_RADIX
Mask to extract the exponent radix: the radix for the exponent digits.
EXPONENT_RADIX_SHIFT
Shift to convert to and from an exponent radix as a u32.
EXPONENT_TRAILING_DIGIT_SEPARATOR
A digit separator is allowed after any exponent digits.
FORTRAN_LITERAL
Number format for a FORTRAN literal floating-point number.
FORTRAN_STRING
Number format to parse a FORTRAN float from string.
FRACTION_CONSECUTIVE_DIGIT_SEPARATOR
Multiple consecutive fraction digit separators are allowed.
FRACTION_INTERNAL_DIGIT_SEPARATOR
Digit separators are allowed between fraction digits.
FRACTION_LEADING_DIGIT_SEPARATOR
A digit separator is allowed before any fraction digits.
FRACTION_TRAILING_DIGIT_SEPARATOR
A digit separator is allowed after any fraction digits.
FSHARP_LITERAL
Number format for a F# literal floating-point number.
FSHARP_STRING
Number format to parse a F# float from string.
GAMBITC_LITERAL
Number format for a Gambit-C literal floating-point number.
GAMBITC_STRING
Number format to parse a Gambit-C float from string.
GO_LITERAL
Number format for a Golang literal floating-point number.
GO_STRING
Number format to parse a Golang float from string.
GUILE_LITERAL
Number format for a Guile literal floating-point number.
GUILE_STRING
Number format to parse a Guile float from string.
HASKELL_LITERAL
Number format for a Haskell literal floating-point number.
HASKELL_STRING
Number format to parse a Haskell float from string.
INTEGER_CONSECUTIVE_DIGIT_SEPARATOR
Multiple consecutive integer digit separators are allowed.
INTEGER_INTERNAL_DIGIT_SEPARATOR
Digit separators are allowed between integer digits.
INTEGER_LEADING_DIGIT_SEPARATOR
A digit separator is allowed before any integer digits.
INTEGER_TRAILING_DIGIT_SEPARATOR
A digit separator is allowed after any integer digits.
INTERNAL_DIGIT_SEPARATOR
Digit separators are allowed between digits.
JAVASCRIPT_LITERAL
Number format for a Javascript literal floating-point number.
JAVASCRIPT_STRING
Number format to parse a Javascript float from string.
JAVA_LITERAL
Number format for a Java literal floating-point number.
JAVA_STRING
Number format to parse a Java float from string.
JSON
Number format for a JSON literal floating-point number.
JULIA_LITERAL
Number format for a Julia literal floating-point number.
JULIA_STRING
Number format to parse a Julia float from string.
KAWA_LITERAL
Number format for a Kawa literal floating-point number.
KAWA_STRING
Number format to parse a Kawa float from string.
KOTLIN_LITERAL
Number format for a Kotlin literal floating-point number.
KOTLIN_STRING
Number format to parse a Kotlin float from string.
LEADING_DIGIT_SEPARATOR
A digit separator is allowed before any digits.
MANTISSA_RADIX
Mask to extract the mantissa radix: the radix for the significant digits.
MANTISSA_RADIX_SHIFT
Shift to convert to and from a mantissa radix as a u32.
MATLAB_LITERAL
Number format for an Matlab literal floating-point number.
MATLAB_STRING
Number format to parse an Matlab float from string.
MONGODB
Number format for a MongoDB literal floating-point number.
MYSQL
Number format for a MySQL literal floating-point number.
NO_EXPONENT_NOTATION
Exponent notation is not allowed.
NO_EXPONENT_WITHOUT_FRACTION
Exponent without a fraction component is not allowed.
NO_FLOAT_LEADING_ZEROS
Leading zeros before a float value are not allowed.
NO_INTEGER_LEADING_ZEROS
Leading zeros before an integer value are not allowed.
NO_POSITIVE_EXPONENT_SIGN
Positive sign before the exponent is not allowed.
NO_POSITIVE_MANTISSA_SIGN
Positive sign before the mantissa is not allowed.
NO_SPECIAL
Special (non-finite) values are not allowed.
OBJECTIVEC_LITERAL
Number format for an Objective-C literal floating-point number.
OBJECTIVEC_STRING
Number format to parse an Objective-C float from string.
OCAML_LITERAL
Number format for an OCaml literal floating-point number.
OCAML_STRING
Number format to parse an OCaml float from string.
OCTAVE_LITERAL
Number format for an Octave literal floating-point number.
OCTAVE_STRING
Number format to parse an Octave float from string.
PERL_LITERAL
Number format for a Perl literal floating-point number.
PERL_STRING
Number format to parse a Perl float from string.
PHP_LITERAL
Number format for a PHP literal floating-point number.
PHP_STRING
Number format to parse a PHP float from string.
POSTGRESQL
Number format for a PostgreSQL literal floating-point number.
PYTHON2_LITERAL
Number format for a Python2 literal floating-point number.
PYTHON2_STRING
Number format to parse a Python2 float from string.
PYTHON3_LITERAL
Number format for a Python3 literal floating-point number.
PYTHON3_STRING
Number format to parse a Python3 float from string.
PYTHON35_LITERAL
Number format for a Python3.5 or lower literal floating-point number.
PYTHON36_LITERAL
Number format for a Python3.6 or higher literal floating-point number.
PYTHON_LITERAL
Number format for a Python literal floating-point number.
PYTHON_STRING
Number format to parse a Python float from string.
RADIX
Alias for MANTISSA_RADIX.
RADIX_SHIFT
Alias for MANTISSA_RADIX_SHIFT.
REASONML_LITERAL
Number format for a ReasonML literal floating-point number.
REASONML_STRING
Number format to parse a ReasonML float from string.
REQUIRED_DIGITS
At least 1 digit in the number is required.
REQUIRED_EXPONENT_DIGITS
Digits are required after the exponent character. This check will only occur if the exponent character is present.
REQUIRED_EXPONENT_NOTATION
Exponent notation is required.
REQUIRED_EXPONENT_SIGN
Positive sign before the exponent is required.
REQUIRED_FRACTION_DIGITS
Digits are required after the decimal point. This check will only occur if the decimal point is present.
REQUIRED_INTEGER_DIGITS
Digits are required before the decimal point.
REQUIRED_MANTISSA_DIGITS
Mantissa digits are required (either before or after the decimal point).
REQUIRED_MANTISSA_SIGN
Positive sign before the mantissa is required.
RUBY_LITERAL
Number format for a Ruby literal floating-point number.
RUBY_STRING
Number format to parse a Ruby float from string.
RUST_LITERAL
Number format for a Rust literal floating-point number.
RUST_STRING
Number format to parse a Rust float from string.
R_LITERAL
Number format for a R literal floating-point number.
R_STRING
Number format to parse a R float from string.
SAGE_LITERAL
Number format for a Sage literal floating-point number.
SAGE_STRING
Number format to parse a Sage float from string.
SCALA_LITERAL
Number format for a Scala literal floating-point number.
SCALA_STRING
Number format to parse a Scala float from string.
SPECIAL_DIGIT_SEPARATOR
Any digit separators are allowed in special (non-finite) values.
SQLITE
Number format for a SQLite literal floating-point number.
STANDARD
Standard number format. This is identical to the Rust string format.
SWIFT_LITERAL
Number format for a Swift literal floating-point number.
SWIFT_STRING
Number format to parse a Swift float from string.
TOML
Number format for a TOML literal floating-point number.
TRAILING_DIGIT_SEPARATOR
A digit separator is allowed after any digits.
VB_LITERAL
Number format for a Visual Basic literal floating-point number.
VB_STRING
Number format to parse a Visual Basic float from string.
XML
Number format for a XML literal floating-point number.
YAML
Number format for a YAML literal floating-point number.
ZIG_LITERAL
Number format for a Zig literal floating-point number.
ZIG_STRING
Number format to parse a Zig float from string.

Functions§

base_prefix
Extract the base prefix character from the format packed struct.
base_suffix
Extract the base suffix character from the format packed struct.
digit_separator
Extract the digit separator from the format packed struct.
exponent_base
Extract the exponent base from the format packed struct. If not provided, defaults to mantissa_radix.
exponent_radix
Extract the exponent radix from the format packed struct. If not provided, defaults to mantissa_radix.
format_error
Get the error type from the format packed struct.
format_is_valid
Determine if the format packed struct is valid.
is_valid_base_prefix
Determine if the base prefix character is valid.
is_valid_base_suffix
Determine if the base suffix character is valid.
is_valid_digit_separator
Determine if the digit separator is valid. Digit separators must not be valid digits or sign characters.
is_valid_exponent_flags
Determine if the provided exponent flags are valid.
is_valid_options_punctuation
Determine if all of the “punctuation” characters for the options API are valid.
is_valid_punctuation
Determine if all of the “punctuation” characters are valid.
is_valid_radix
Determine if the radix is valid.
mantissa_radix
Extract the mantissa radix from the format packed struct.
radix_from_flags
Extract a generic radix from the format and bitflags.

Type Aliases§

OptionU8
Type with the exact same size as a u8.