Skip to content

Commit b6454e3

Browse files
committed
[format.string] Further clarify description of cases where formatting is
described in terms of a call to to_chars.
1 parent f430bec commit b6454e3

File tree

1 file changed

+18
-21
lines changed

1 file changed

+18
-21
lines changed

source/utilities.tex

Lines changed: 18 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -19979,24 +19979,23 @@
1997919979
\end{floattable}
1998019980

1998119981
\pnum
19982-
Formatting of objects of non-string types
19983-
is done as if by calling \tcode{to_chars} (unless otherwise specified)
19982+
The meaning of some non-string presentation types
19983+
is defined in terms of a call to \tcode{to_chars}.
19984+
In such cases,
19985+
let \range{first}{last} be a range
19986+
large enough to hold the \tcode{to_chars} output
19987+
and \tcode{value} be the formatting argument value.
19988+
Formatting is done as if by calling \tcode{to_chars} as specified
1998419989
and copying the output through the output iterator of the format context.
1998519990
\begin{note}
1998619991
Additional padding and adjustments are performed
1998719992
prior to copying the output through the output iterator
1998819993
as specified by the format specifiers.
1998919994
\end{note}
1999019995

19991-
\pnum
19992-
Let \range{first}{last} be a range
19993-
large enough to hold the \tcode{to_chars} output
19994-
and \tcode{value} be the formatting argument value.
19995-
1999619996
\pnum
1999719997
The available integer presentation types
19998-
for integral types other than \tcode{bool} and \tcode{charT},
19999-
and their mapping to \tcode{to_chars},
19998+
for integral types other than \tcode{bool} and \tcode{charT}
2000019999
are specified in \tref{format.type.int}.
2000120000
\begin{example}
2000220001
\begin{codeblock}
@@ -20101,9 +20100,17 @@
2010120100
\end{floattable}
2010220101

2010320102
\pnum
20104-
The available floating-point presentation types and their mapping to
20105-
\tcode{to_chars} (for values other than infinity and NaN) are
20103+
The available floating-point presentation types and their meanings
20104+
for values other than infinity and NaN are
2010620105
specified in \tref{format.type.float}.
20106+
For lower-case presentation types, infinity and NaN are formatted as
20107+
\tcode{inf} and \tcode{nan}, respectively.
20108+
For upper-case presentation types, infinity and NaN are formatted as
20109+
\tcode{INF} and \tcode{NAN}, respectively.
20110+
\begin{note}
20111+
In either case, a sign is included
20112+
if indicated by the \fmtgrammarterm{sign} option.
20113+
\end{note}
2010720114
%
2010820115
\begin{floattable}{Meaning of \fmtgrammarterm{type} options for floating-point types}{format.type.float}{lp{.8\hsize}}
2010920116
\topline
@@ -20182,16 +20189,6 @@
2018220189
\\
2018320190
\end{floattable}
2018420191

20185-
\pnum
20186-
For lower-case presentation types, infinity and NaN are formatted as
20187-
\tcode{inf} and \tcode{nan}, respectively.
20188-
For upper-case presentation types, infinity and NaN are formatted as
20189-
\tcode{INF} and \tcode{NAN}, respectively.
20190-
\begin{note}
20191-
In either case, a sign is included
20192-
if indicated by the \fmtgrammarterm{sign} option.
20193-
\end{note}
20194-
2019520192
\pnum
2019620193
The available pointer presentation types and their mapping to
2019720194
\tcode{to_chars} are specified in \tref{format.type.ptr}.

0 commit comments

Comments
 (0)