mirror/fmt
1
0
Fork 0
mirror of https://github.com/fmtlib/fmt.git synced 2025-01-09 15:36:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update syntax.rst

Browse Source
This commit is contained in:
Victor Zverovich 2024-03-30 15:54:39 -07:00 committed by GitHub
parent 3b5f3de3b5
commit f5ec5ada2b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 10 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/syntax.rst
View File

@ -491,7 +491,7 @@ Range Format Specifications
Format specifications for range types have the following syntax:
.. productionlist:: sf
range_format_spec: [":" ["n"][`range_type`][`range_underlying_spec`]]
range_format_spec: ["n"][`range_type`][`range_underlying_spec`]
The ``'n'`` option formats the range without the opening and closing brackets.
@ -500,23 +500,24 @@ The available presentation types for `range_type` are:
+---------+----------------------------------------------------------+
| Type | Meaning |
+=========+==========================================================+
| none | Default format. |
+---------+----------------------------------------------------------+
| ``'s'`` | String format. The range is formatted as a string. |
+---------+----------------------------------------------------------+
| ``'?s'``| Debug format. The range is formatted as an escaped |
| | string. |
+---------+----------------------------------------------------------+
| none | Default format. The range is formatted with a separator. |
+---------+----------------------------------------------------------+
If `range_type` is ``'s'`` or ``'?s'``, the range element type must be a character type. The
``'n'`` option and `range_underlying_spec` are mutually exclusive with ``'s'`` and ``'?s'``.
If `range_type` is ``'s'`` or ``'?s'``, the range element type must be a
character type. The ``'n'`` option and `range_underlying_spec` are mutually
exclusive with ``'s'`` and ``'?s'``.
The `range_underlying_spec` is parsed based on the formatter of the range's
reference type.
element type.
By default, a range of characters or strings is printed escaped and quoted. But
if any `range_underlying_spec` is provided (even if it is empty), then the characters
or strings are printed according to the provided specification.
By default, a range of characters or strings is printed escaped and quoted.
But if any `range_underlying_spec` is provided (even if it is empty), then
the characters or strings are printed according to the provided specification.
Examples::