diff --git a/doc/Text Formatting.html b/doc/Text Formatting.html index 0d4a8d66..e20eae36 100644 --- a/doc/Text Formatting.html +++ b/doc/Text Formatting.html @@ -516,24 +516,24 @@ The meaning of the various alignment options is as follows:
'<''>''='+000000120. This alignment option is only valid for numeric
types.'^''+''-'TODO
+
+The '#' option causes the alternate form"0b" ("0B"), "0", or
+"0x" ("0X") to the output value. Whether the prefix
+is lower-case or upper-case is determined by the case of the type specifier,
+for example, the prefix "0x" is used for the type 'x'
+and "0X" is used for 'X'. For floating-point numbers
+the alternate form causes the result of the conversion to always contain a
+decimal-point character, even if no digits follow it. Normally, a decimal-point
+character appears in the result of these conversions only if a digit follows it.
+In addition, for 'g' and 'G' conversions, trailing
+zeros are not removed from the result.
+
+width is a decimal integer defining the minimum field width. If
+not specified, then the field width will be determined by the content.
+
+Preceding the width field by a zero ('0') character
+enables sign-aware zero-padding for numeric types. This is equivalent to a
+fill character of '0' with an alignment
+type of '='.
+
+The precision is a decimal number indicating how many digits should
+be displayed after the decimal point for a floating-point value formatted with
+'f' and 'F', or before and after the decimal point
+for a floating-point value formatted with 'g' or 'G'.
+For non-number types the field indicates the maximum field size - in other
+words, how many characters will be used from the field content. The
+precision is not allowed for integer, character, Boolean, and
+pointer values.
+
+Finally, the type determines how the data should be presented.
+
The available string presentation types are:
+ +| Type | Meaning |
|---|---|
's' |
+String format. This is the default type for strings and may be omitted. | +
| none | +The same as 's'. |
+
The available character presentation types are:
+ +| Type | Meaning |
|---|---|
'c' |
+Character format. This is the default type for characters and may be + omitted. | +
| none | +The same as 'c'. |
+
The available integer presentation types are:
+ +| Type | Meaning |
|---|---|
'b' |
+Binary format. Outputs the number in base 2. Using the '#'
+ option with this type adds the prefix "0b" to the output
+ value. |
+
'B' |
+Binary format. Outputs the number in base 2. Using the '#'
+ option with this type adds the prefix "0B" to the output
+ value. |
+
'd' |
+Decimal integer. Outputs the number in base 10. | +
'o' |
+Octal format. Outputs the number in base 8. | +
'x' |
+Hex format. Outputs the number in base 16, using lower-case letters for the
+ digits above 9. Using the '#' option with this type adds the
+ prefix "0x" to the output value. |
+
'X' |
+Hex format. Outputs the number in base 16, using upper-case letters for the
+ digits above 9. Using the '#' option with this type adds the
+ prefix "0X" to the output value. |
+
'n' |
+Number. This is the same as 'd', except that it uses the
+ current locale setting to insert the appropriate number separator
+ characters. |
+
| none | +The same as 'd'. |
+
+Integer presentation types can also be used with character and Boolean values. +Boolean values are formatted using textual representation, either true or false, +if the presentation type is not specified. +
+ +The available presentation types for floating-point values are:
+ +| Type | Meaning |
|---|---|
'a' |
+Hexadecimal floating point format. Prints the number in base 16 with prefix
+ "0x" and lower-case letters for digits above 9. Uses
+ 'p' to indicate the exponent. |
+
'A' |
+Same as 'a' except it uses upper-case letters for the prefix,
+ digits above 9 and to indicate the exponent. |
+
'e' |
+Exponent notation. Prints the number in scientific notation using the
+ letter 'e' to indicate the exponent. |
+
'E' |
+Exponent notation. Same as 'e' except it uses an upper-case
+ 'E' as the separator character. |
+
'f' |
+Fixed point. Displays the number as a fixed-point number. | +
'F' |
+Fixed point. Same as 'f', but converts nan to
+ NAN and inf to INF. |
+
'g' |
+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.
+
+ A precision of 0 is treated as equivalent to a precision of
+ 1. |
+
'n' |
+Number. This is the same as 'g', except that it uses the
+ current locale setting to insert the appropriate number separator
+ characters. |
+
| none | +The same as 'g'. |
+
The available presentation types for pointers are:
+ +| Type | Meaning |
|---|---|
'p' |
+Pointer format. This is the default type for pointers and may be + omitted. | +
| none | +The same as 'p'. |
+
format_error