AuroraMiddleware/glibc
1
0
Fork 0
mirror of https://sourceware.org/git/glibc.git synced 2024-12-26 12:41:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document '%F' format specifier

Browse Source 
The '%F' format specifier was implemented in commit 6c46718f9f on
2000-08-23, but remains undocumented in the manual.
https://stackoverflow.com/questions/75157669/format-specifier-f-missing-from-glibcs-documentation

Fix that.

Reviewed-by: Siddhesh Poyarekar <siddhesh@sourceware.org>
This commit is contained in:
Paul Pluzhnikov 2023-01-25 00:39:31 +00:00
parent 33f0f58b59
commit 0674613e66
1 changed files with 12 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
manual/stdio.texi
View File

@ -1845,8 +1845,9 @@ Print an integer as an unsigned hexadecimal number. @samp{%x} uses
lower-case letters and @samp{%X} uses upper-case. @xref{Integer lower-case letters and @samp{%X} uses upper-case. @xref{Integer
Conversions}, for details. Conversions}, for details.
@item @samp{%f} @item @samp{%f}, @samp{%F}
Print a floating-point number in normal (fixed-point) notation. Print a floating-point number in normal (fixed-point) notation.
@samp{%f} uses lower-case letters and @samp{%F} uses upper-case.
@xref{Floating-Point Conversions}, for details. @xref{Floating-Point Conversions}, for details.
@item @samp{%e}, @samp{%E} @item @samp{%e}, @samp{%E}
@ -2073,11 +2074,11 @@ various format options, using the template string:
@subsection Floating-Point Conversions @subsection Floating-Point Conversions
This section discusses the conversion specifications for floating-point This section discusses the conversion specifications for floating-point
numbers: the @samp{%f}, @samp{%e}, @samp{%E}, @samp{%g}, and @samp{%G} numbers: the @samp{%f}, @samp{%F}, @samp{%e}, @samp{%E}, @samp{%g}, and
conversions. @samp{%G} conversions.
The @samp{%f} conversion prints its argument in fixed-point notation, The @samp{%f} and @samp{%F} conversions print their argument in fixed-point
producing output of the form notation, producing output of the form
@w{[@code{-}]@var{ddd}@code{.}@var{ddd}}, @w{[@code{-}]@var{ddd}@code{.}@var{ddd}},
where the number of digits following the decimal point is controlled where the number of digits following the decimal point is controlled
by the precision you specify. by the precision you specify.
@ -2093,7 +2094,7 @@ the precision. The exponent always contains at least two digits. The
The @samp{%g} and @samp{%G} conversions print the argument in the style The @samp{%g} and @samp{%G} conversions print the argument in the style
of @samp{%e} or @samp{%E} (respectively) if the exponent would be less of @samp{%e} or @samp{%E} (respectively) if the exponent would be less
than -4 or greater than or equal to the precision; otherwise they use than -4 or greater than or equal to the precision; otherwise they use
the @samp{%f} style. A precision of @code{0}, is taken as 1. the @samp{%f} or @samp{%F} style. A precision of @code{0}, is taken as 1.
Trailing zeros are removed from the fractional portion of the result and Trailing zeros are removed from the fractional portion of the result and
a decimal-point character appears only if it is followed by a digit. a decimal-point character appears only if it is followed by a digit.
@ -2123,7 +2124,7 @@ If the value to be printed represents infinity or a NaN, the output is
@w{[@code{-}]@code{inf}} or @code{nan} respectively if the conversion @w{[@code{-}]@code{inf}} or @code{nan} respectively if the conversion
specifier is @samp{%a}, @samp{%e}, @samp{%f}, or @samp{%g} and it is specifier is @samp{%a}, @samp{%e}, @samp{%f}, or @samp{%g} and it is
@w{[@code{-}]@code{INF}} or @code{NAN} respectively if the conversion is @w{[@code{-}]@code{INF}} or @code{NAN} respectively if the conversion is
@samp{%A}, @samp{%E}, or @samp{%G}. On some implementations, a NaN @samp{%A}, @samp{%E}, @samp{%F} or @samp{%G}. On some implementations, a NaN
may result in longer output with information about the payload of the may result in longer output with information about the payload of the
NaN; ISO C2X defines a macro @code{_PRINTF_NAN_LEN_MAX} giving the NaN; ISO C2X defines a macro @code{_PRINTF_NAN_LEN_MAX} giving the
maximum length of such output. maximum length of such output.
@ -2162,8 +2163,8 @@ specified.
@end table @end table
The precision specifies how many digits follow the decimal-point The precision specifies how many digits follow the decimal-point
character for the @samp{%f}, @samp{%e}, and @samp{%E} conversions. For character for the @samp{%f}, @samp{%F}, @samp{%e}, and @samp{%E} conversions.
these conversions, the default precision is @code{6}. If the precision For these conversions, the default precision is @code{6}. If the precision
is explicitly @code{0}, this suppresses the decimal point character is explicitly @code{0}, this suppresses the decimal point character
entirely. For the @samp{%g} and @samp{%G} conversions, the precision entirely. For the @samp{%g} and @samp{%G} conversions, the precision
specifies how many significant digits to print. Significant digits are specifies how many significant digits to print. Significant digits are
@ -3535,7 +3536,7 @@ Matches an unsigned integer written in decimal radix.
Matches an unsigned integer written in hexadecimal radix. Matches an unsigned integer written in hexadecimal radix.
@xref{Numeric Input Conversions}. @xref{Numeric Input Conversions}.
@item @samp{%e}, @samp{%f}, @samp{%g}, @samp{%E}, @samp{%G} @item @samp{%e}, @samp{%f}, @samp{%g}, @samp{%E}, @samp{%F}, @samp{%G}
Matches an optionally signed floating-point number. @xref{Numeric Input Matches an optionally signed floating-point number. @xref{Numeric Input
Conversions}. Conversions}.
@ -3691,7 +3692,7 @@ Specifies that the argument is a @code{size_t *}.
This modifier was introduced in @w{ISO C99}. This modifier was introduced in @w{ISO C99}.
@end table @end table
All of the @samp{%e}, @samp{%f}, @samp{%g}, @samp{%E}, and @samp{%G} All of the @samp{%e}, @samp{%f}, @samp{%g}, @samp{%E}, @samp{%F} and @samp{%G}
input conversions are interchangeable. They all match an optionally input conversions are interchangeable. They all match an optionally
signed floating point number, in the same syntax as for the signed floating point number, in the same syntax as for the
@code{strtod} function (@pxref{Parsing of Floats}). @code{strtod} function (@pxref{Parsing of Floats}).