1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

update sprintf rdoc.

Browse Source 
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@16100 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
akr 2008-04-20 06:44:41 +00:00
parent 5e433ffc6c
commit 6aee0a5bca
1 changed files with 62 additions and 59 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

121
sprintf.c
View File

@ -156,14 +156,63 @@ sign_bits(int base, const char *p)
* width, and precision indicators, then terminated with a field type * width, and precision indicators, then terminated with a field type
* character. The field type controls how the corresponding * character. The field type controls how the corresponding
* <code>sprintf</code> argument is to be interpreted, while the flags * <code>sprintf</code> argument is to be interpreted, while the flags
* modify that interpretation. The field type characters are listed * modify that interpretation.
* in the table at the end of this section. The flag characters are: *
* The field type characters are:
*
* Field | Integer Format
* ------+--------------------------------------------------------------
* b | Convert argument as a binary number.
* | Negative numbers will be displayed as a two's complement
* | prefixed with `..1'.
* B | Equivalent to `b', but uses an uppercase 0B for prefix
* | in the alternative format by #.
* d | Convert argument as a decimal number.
* i | Identical to `d'.
* o | Convert argument as an octal number.
* | Negative numbers will be displayed as a two's complement
* | prefixed with `..7'.
* u | Identical to `d'.
* x | Convert argument as a hexadecimal number.
* | Negative numbers will be displayed as a two's complement
* | prefixed with `..f' (representing an infinite string of
* | leading 'ff's).
* X | Equivalent to `x', but uses uppercase letters.
*
* Field | Float Format
* ------+--------------------------------------------------------------
* e | Convert floating point argument into exponential notation
* | with one digit before the decimal point as [-]d.dddddde[+-]dd.
* | The precision specifies the number of digits after the decimal
* | point (defaulting to six).
* E | Equivalent to `e', but uses an uppercase E to indicate
* | the exponent.
* f | Convert floating point argument as [-]ddd.dddddd,
* | where the precision specifies the number of digits after
* | the decimal point.
* g | Convert a floating point number using exponential form
* | if the exponent is less than -4 or greater than or
* | equal to the precision, or in dd.dddd form otherwise.
* | The precision specifies the number of significant digits.
* G | Equivalent to `g', but use an uppercase `E' in exponent form.
*
* Field | Other Format
* ------+--------------------------------------------------------------
* c | Argument is the numeric code for a single character or
* | a single character string itself.
* p | The valuing of argument.inspect.
* s | Argument is a string to be substituted. If the format
* | sequence contains a precision, at most that many characters
* | will be copied.
*
* The flags modifies the behavior of the formats.
* The flag characters are:
* *
* Flag | Applies to | Meaning * Flag | Applies to | Meaning
* ---------+---------------+----------------------------------------- * ---------+---------------+-----------------------------------------
* space | bBdeEfgGiouxX | Leave a space at the start of * space | bBdiouxX | Leave a space at the start of
* | | non-negative numbers. * | eEfgG | non-negative numbers.
* | | For `o', `x', `X', `b' and `B', use * | (numeric fmt) | For `o', `x', `X', `b' and `B', use
* | | a minus sign with absolute value for * | | a minus sign with absolute value for
* | | negative values. * | | negative values.
* ---------+---------------+----------------------------------------- * ---------+---------------+-----------------------------------------
@ -172,8 +221,8 @@ sign_bits(int base, const char *p)
* | | argument numbers cannot be mixed in a * | | argument numbers cannot be mixed in a
* | | sprintf string. * | | sprintf string.
* ---------+---------------+----------------------------------------- * ---------+---------------+-----------------------------------------
* # | bBeEfgGoxX | Use an alternative format. * # | bBoxX | Use an alternative format.
* | | For the conversions `o', increase the precision * | eEfgG | For the conversions `o', increase the precision
* | | until the first digit will be `0' if * | | until the first digit will be `0' if
* | | it is not formatted as complements. * | | it is not formatted as complements.
* | | For the conversions `x', `X', `b' and `B' * | | For the conversions `x', `X', `b' and `B'
@ -184,17 +233,17 @@ sign_bits(int base, const char *p)
* | | even if no digits follow. * | | even if no digits follow.
* | | For `g' and 'G', do not remove trailing zeros. * | | For `g' and 'G', do not remove trailing zeros.
* ---------+---------------+----------------------------------------- * ---------+---------------+-----------------------------------------
* + | bBdeEfgGiouxX | Add a leading plus sign to non-negative * + | bBdiouxX | Add a leading plus sign to non-negative
* | | numbers. * | eEfgG | numbers.
* | | For `o', `x', `X', `b' and `B', use * | (numeric fmt) | For `o', `x', `X', `b' and `B', use
* | | a minus sign with absolute value for * | | a minus sign with absolute value for
* | | negative values. * | | negative values.
* ---------+---------------+----------------------------------------- * ---------+---------------+-----------------------------------------
* - | all | Left-justify the result of this conversion. * - | all | Left-justify the result of this conversion.
* ---------+---------------+----------------------------------------- * ---------+---------------+-----------------------------------------
* 0 (zero) | bBdeEfgGiouxX | Pad with zeros, not spaces. * 0 (zero) | bBdiouxX | Pad with zeros, not spaces.
* | | For `o', `x', `X', `b' and `B', radix-1 * | eEfgG | For `o', `x', `X', `b' and `B', radix-1
* | | is used for negative numbers formatted as * | (numeric fmt) | is used for negative numbers formatted as
* | | complements. * | | complements.
* ---------+---------------+----------------------------------------- * ---------+---------------+-----------------------------------------
* * | all | Use the next argument as the field width. * * | all | Use the next argument as the field width.
@ -202,12 +251,6 @@ sign_bits(int base, const char *p)
* | | asterisk is followed by a number and a dollar * | | asterisk is followed by a number and a dollar
* | | sign, use the indicated argument as the width. * | | sign, use the indicated argument as the width.
* *
* For `o', `x', `X', `b' and `B',
* negative values are formatted by compelements
* prefixed with `..' and radix-1.
* If a space or `+' flag is specified,
* a minus sign and absolute value is used instead.
*
* Examples of flags: * Examples of flags:
* *
* # `+' and space flag specifies the sign of non-negative numbers. * # `+' and space flag specifies the sign of non-negative numbers.
@ -332,46 +375,6 @@ sign_bits(int base, const char *p)
* # maximum number of characters <------> * # maximum number of characters <------>
* sprintf("%20.8s", "string test") #=> " string t" * sprintf("%20.8s", "string test") #=> " string t"
* *
* The field types are:
*
* Field | Conversion
* ------+--------------------------------------------------------------
* b | Convert argument as a binary number.
* B | Equivalent to `b', but uses an uppercase 0B for prefix
* | in the alternative format by #.
* c | Argument is the numeric code for a single character or
* | a single character string itself.
* d | Convert argument as a decimal number.
* e | Convert floating point argument into exponential notation
* | with one digit before the decimal point. The precision
* | determines the number of digits after the decimal point
* | (defaulting to six).
* E | Equivalent to `e', but uses an uppercase E to indicate
* | the exponent.
* f | Convert floating point argument as [-]ddd.ddd,
* | where the precision determines the number of digits after
* | the decimal point.
* g | Convert a floating point number using exponential form
* | if the exponent is less than -4 or greater than or
* | equal to the precision, or in d.dddd form otherwise.
* | The precision specifies the number of significant digits.
* G | Equivalent to `g', but use an uppercase `E' in exponent form.
* i | Identical to `d'.
* o | Convert argument as an octal number.
* p | The valuing of argument.inspect.
* s | Argument is a string to be substituted. If the format
* | sequence contains a precision, at most that many characters
* | will be copied.
* u | Identical to `d'.
* x | Convert argument as a hexadecimal number.
* | Negative numbers will be displayed with two
* | leading periods (representing an infinite string of
* | leading 'ff's.
* X | Convert argument as a hexadecimal number using uppercase
* | letters. Negative numbers will be displayed with two
* | leading periods (representing an infinite string of
* | leading 'FF's.
*
* Examples: * Examples:
* *
* sprintf("%d %04x", 123, 123) #=> "123 007b" * sprintf("%d %04x", 123, 123) #=> "123 007b"