What precisely does the %g printf specifier mean?

by

This is the full description of the g/G specifier in the C11 standard:

A double argument representing a floating-point number is
converted in style f or e (or in style F or E in the case of a G
conversion specifier), depending on the value converted and the
precision. Let P equal the precision if nonzero, 6 if the precision is
omitted, or 1 if the precision is zero. Then, if a conversion with
style E would have an exponent of X:

     if P > X ≥ −4, the conversion is
with style f (or F) and precision P − (X + 1).
     otherwise, the
conversion is with style e (or E) and precision P − 1.

Finally, unless
the # flag is used, any trailing zeros are removed from the fractional
portion of the result and the decimal-point character is removed if
there is no fractional portion remaining.

A double argument
representing an infinity or NaN is converted in the style of an f or F
conversion specifier.

This behaviour is somewhat similar to simply using the shortest representation out of %f and %e, but not equivalent. There are two important differences:

  • Trailing zeros (and, potentially, the decimal point) get stripped when using %g, which can cause the output of a %g specifier to not exactly match what either %f or %e would’ve produced.
  • The decision about whether to use %f-style or %e-style formatting is made based purely upon the size of the exponent that would be needed in %e-style notation, and does not directly depend on which representation would be shorter. There are several scenarios in which this rule results in %g selecting the longer representation, like the one shown in the question where %g uses scientific notation even though this makes the output 4 characters longer than it needs to be.

In case the C standard’s wording is hard to parse, the Python documentation provides another description of the same behaviour:

General format. For a given precision p >= 1,
this rounds the number to p significant digits and
then formats the result in either fixed-point format
or in scientific notation, depending on its magnitude.

The precise rules are as follows: suppose that the
result formatted with presentation type 'e' and
precision p-1 would have exponent exp. Then
if -4 <= exp < p, the number is formatted
with presentation type 'f' and precision
p-1-exp. Otherwise, the number is formatted
with presentation type 'e' and precision p-1.
In both cases insignificant trailing zeros are removed
from the significand, and the decimal point is also
removed if there are no remaining digits following it.

Positive and negative infinity, positive and negative
zero, and nans, are formatted as inf, -inf,
0, -0 and nan respectively, regardless of
the precision.

A precision of 0 is treated as equivalent to a
precision of 1. The default precision is 6.

The many sources on the internet that claim that %g just picks the shortest out of %e and %f are simply wrong.

More Related Contents:

  1. Correct format specifier for double in printf
  2. Please explain the difference in the printfs below
  3. char c[]=”Albus”; printf(“%c”, c); [closed]
  4. Printf width specifier to maintain precision of floating-point value
  5. The “backspace” escape character ‘\b’: unexpected behavior?
  6. How do you format an unsigned long long int using printf?
  7. What does “%.*s” mean in printf?
  8. What is the purpose of the h and hh modifiers for printf?
  9. What happens to a float variable when %d is used in a printf?
  10. How to printf “unsigned long” in C?
  11. Why is printf round floating point numbers up?
  12. Why is printf with a single argument (without conversion specifiers) deprecated?
  13. How does printf and co differentiate between float and double
  14. C printf using %d and %f
  15. C dynamically printf double, no loss of precision and no trailing zeroes
  16. Why does printf not flush after the call unless a newline is in the format string?
  17. Printing leading 0’s in C
  18. ‘float’ vs. ‘double’ precision
  19. How should I print types like off_t and size_t?
  20. printf format specifiers for uint32_t and size_t
  21. printf adds extra `FFFFFF` to hex print from a char array [duplicate]
  22. call printf using va_list
  23. Behaviour of printf when printing a %d without supplying variable name
  24. How to extract the decimal part from a floating point number in C?
  25. What does `scanf(“%*[^\n]%*c”)` mean?
  26. Determining sprintf buffer size – what’s the standard?
  27. Precision in C floats
  28. My floating point number has extra digits when I print it
  29. Is there a function to round a float in C or do I need to write my own?
  30. Conditional tests in primality by trial division

Leave a Comment