1
0
mirror of https://github.com/golang/go synced 2024-11-24 22:10:02 -07:00

fmt/doc: define width and precision for strings.

R=rsc
CC=golang-dev
https://golang.org/cl/4061045
This commit is contained in:
Rob Pike 2011-01-26 11:10:41 -08:00
parent a64e63227a
commit 4e2218968c

View File

@ -26,7 +26,7 @@
%o base 8 %o base 8
%x base 16, with lower-case letters for a-f %x base 16, with lower-case letters for a-f
%X base 16, with upper-case letters for A-F %X base 16, with upper-case letters for A-F
%U unicode format: U+1234; same as "U+%x" with 4 digits default %U Unicode format: U+1234; same as "U+%x" with 4 digits default
Floating-point and complex constituents: Floating-point and complex constituents:
%e scientific notation, e.g. -1234.456e+78 %e scientific notation, e.g. -1234.456e+78
%E scientific notation, e.g. -1234.456E+78 %E scientific notation, e.g. -1234.456E+78
@ -44,14 +44,19 @@
There is no 'u' flag. Integers are printed unsigned if they have unsigned type. There is no 'u' flag. Integers are printed unsigned if they have unsigned type.
Similarly, there is no need to specify the size of the operand (int8, int64). Similarly, there is no need to specify the size of the operand (int8, int64).
For numeric values, the width and precision flags control The width and precision control formatting and are in units of Unicode
formatting; width sets the width of the field, precision the code points. (This differs from C's printf where the units are numbers
number of places after the decimal, if appropriate. The of bytes.) Either or both of the flags may be replaced with the
format %6.2f prints 123.45. The width of a field is the number character '*', causing their values to be obtained from the next
of Unicode code points in the string. This differs from C's printf where operand, which must be of type int.
the field width is the number of bytes. Either or both of the
flags may be replaced with the character '*', causing their values For numeric values, width sets the width of the field and precision
to be obtained from the next operand, which must be of type int. sets the number of places after the decimal, if appropriate. For
example, the format %6.2f prints 123.45.
For strings, width is the minimum number of characters to output,
padding with spaces if necessary, and precision is the maximum
number of characters to output, truncating if necessary.
Other flags: Other flags:
+ always print a sign for numeric values + always print a sign for numeric values