berkus
/
kdl
mirror of https://github.com/kdl-org/kdl.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clarify what it means for digits to be separated by underscores.

This commit is contained in:
Tab Atkins-Bittner 2025-04-28 12:31:20 -07:00
parent a88c450d7d
commit 421e947fb3
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
draft-marchan-kdl2.md
View File

@ -782,6 +782,13 @@ There are five syntaxes for Numbers: Keywords, Decimal, Hexadecimal, Octal, and
- They may optionally include a decimal separator `.`, followed by more digits, which may again be separated by `_`. - They may optionally include a decimal separator `.`, followed by more digits, which may again be separated by `_`.
- They may optionally be followed by `E` or `e`, an optional `-` or `+`, and more digits, to represent an exponent value. - They may optionally be followed by `E` or `e`, an optional `-` or `+`, and more digits, to represent an exponent value.
In all cases where the above says that digits "may be separated by `_`",
this means that between any two digits, or after the digits, any number of
consecutive `_` characters can appear. Underscores are not allowed *before* the digits.
That is, `1___2` and `12____` are valid (and both equivalent to just `12`), but
`_12` is *not* a valid number (it will instead parse as an identifier string),
nor is `0x_1a` (it will simply be invalid).
Note that, similar to JSON and some other languages, Note that, similar to JSON and some other languages,
numbers without an integer digit (such as `.1`) are illegal. numbers without an integer digit (such as `.1`) are illegal.
They must be written with at least one integer digit, like `0.1`. They must be written with at least one integer digit, like `0.1`.