From 1cad1f8d1c605e527422b569e9daabc60c66f936 Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Sat, 22 Dec 2012 13:36:39 -0500 Subject: [PATCH] fmt: document width and flags a bit more Fixes #4581. R=golang-dev, bradfitz CC=golang-dev https://golang.org/cl/7000052 --- src/pkg/fmt/doc.go | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/src/pkg/fmt/doc.go b/src/pkg/fmt/doc.go index ff947b68a746e..2c925a4228308 100644 --- a/src/pkg/fmt/doc.go +++ b/src/pkg/fmt/doc.go @@ -63,9 +63,10 @@ The default precision for %e and %f is 6; for %g it is the smallest number of digits necessary to identify the value uniquely. - 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. + For most values, width is the minimum number of characters to output, + padding the formatted form with spaces if necessary. + For strings, precision is the maximum number of characters to output, + truncating if necessary. Other flags: + always print a sign for numeric values; @@ -77,7 +78,12 @@ write e.g. U+0078 'x' if the character is printable for %U (%#U). ' ' (space) leave a space for elided sign in numbers (% d); put spaces between bytes printing strings or slices in hex (% x, % X) - 0 pad with leading zeros rather than spaces + 0 pad with leading zeros rather than spaces; + for numbers, this moves the padding after the sign + + Flags are ignored by verbs that do not expect them. + For example there is no alternate decimal format, so %#d and %d + behave identically. For each Printf-like function, there is also a Print function that takes no format and is equivalent to saying %v for every