File: printf_conversion.cat

package info (click to toggle)
scilab 2.4-1
  • links: PTS
  • area: non-free
  • in suites: potato, slink
  • size: 55,196 kB
  • ctags: 38,019
  • sloc: ansic: 231,970; fortran: 148,976; tcl: 7,099; makefile: 4,585; sh: 2,978; csh: 154; cpp: 101; asm: 39; sed: 5
file content (167 lines) | stat: -rw-r--r-- 8,699 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167

printf_conversion(1)        Scilab Documentation         printf_conversion(1)
NAME
  printf_conversion - printf, sprintf, fprintf conversion specifications

DESCRIPTION
  Each conversion specification in the printf , sprintf , f printfformat
  parameter has the following syntax:

  -         A % (percent) sign.

  -         Zero or more options, which modify the meaning of the conversion
            specification.  The following list contains the option characters
            and their meanings:

            -       : Left align, within the field, the result of the conver-
                    sion.

            +       : Begin the result of a signed conversion with a sign (+
                    or -).

            "space" : Prefix a space character to the result if the first
                    character of a signed conversion is not a sign.  If both
                    the (space) and + options appear, the (space) option is
                    ignored.

            #       : Convert the value to an alternate form.  For c, d, i,
                    s, and u conversions, the # option has no effect.  For o
                    conversion, # increases the precision to force the first
                    digit of the result to be a 0 (zero).  For x and X
                    conversions, a nonzero result has 0x or 0X prefixed to
                    it.  For e, E, f, g, and G conversions, the result always
                    contains a decimal point, even if no digits follow it.
                    For g and G conversions, trailing zeros are not removed
                    from the result.

            0       : Pad to the field width, using leading zeros (following
                    any indication of sign or base) for d, i, o, u, x, X, e,
                    E, f, g, and G conversions; no space padding is per-
                    formed.  If the 0 and - (dash) flags both appear, the 0
                    flag is ignored.  For d, i, o u, x, and X conversions, if
                    a precision is specified, the 0 flag is also ignored.

  An optional decimal digit string that specifies the minimum field width.
  If the converted value has fewer characters than the field width, the field
  is padded on the left to the length specified by the field width.  If the
  left-adjustment option is specified, the field is padded on the right.

  An optional precision.  The precision is a . (dot) followed by a decimal
  digit string.  If no precision is given, the parameter is treated as 0
  (zero).  The precision specifies:

       - The minimum number of digits to appear for d, u, o, x, or X conver-
         sions

       - The number of digits to appear after the decimal point for e, E, and
         f conversions

       - The maximum number of significant digits for g and G conversions

       - The maximum number of characters to be printed from a string in an s
         conversion

  -    A character that indicates the type of conversion to be applied:

       %     : Performs no conversion.  Displays %.

       d,i   :Accepts an integer value and converts it to signed decimal
             notation.  The precision specifies the minimum number of digits
             to appear.  If the value being converted can be represented in
             fewer digits, it is expanded with leading zeros.  The default
             precision is 1.  The result of converting a zero value with a
             precision of zero is a null string.  Specifying a field width
             with a zero as a leading character causes the field width value
             to be padded with leading zeros.

       u     :Accepts an integer value and converts it to unsigned decimal
             notation.  The precision specifies the minimum number of digits
             to appear.  If the value being converted can be represented in
             fewer digits, it is expanded with leading zeros.  The default
             precision is 1.  The result of converting a zero value with a
             precision of zero is a null string.  Specifying a field width
             with a zero as the leading character causes the field width
             value to be padded with leading zeros.

       o     :Accepts an integer value and converts it to unsigned octal
             notation.  The precision specifies the minimum number of digits
             to appear.  If the value being converted can be represented in
             fewer digits, it is expanded with leading zeros.  The default
             precision is 1.  The result of converting a zero value with a
             precision of zero is a null string.  Specifying a field width
             with a zero as the leading character causes the field width
             value to be padded with leading zeros.  An octal value for field
             width is not implied.

       x, X  :Accepts an integer value and converts it to unsigned hexade-
             cimal notation.  The letters ``abcdef'' are used for the x
             conversion; the letters ``ABCDEF'' are used for the X conver-
             sion.  The precision specifies the minimum number of digits to
             appear.  If the value being converted can be represented in
             fewer digits, it is expanded with leading zeros.  The default
             precision is 1.  The result of converting a zero value with a
             precision of zero is a null string.  Specifying a field width
             with a zero as the leading character causes the field width
             value to be padded with leading zeros.

       f     : Accepts a float or double value and converts it to decimal
             notation in the format %[-]ddd.ddd.  The number of digits after
             the decimal point is equal to the precision specification.

             - If no precision is specified, six digits are output.

             - If the precision is zero, no decimal point appears and the
               system outputs a number rounded to the integer nearest to
               value.

             - If a decimal point is output, at least one digit is output
               before it.

       e, E  :Accepts a real  and converts it to the exponential form
             %[-]d.ddde+/-dd.  There is one digit before the decimal point,
             and the number of digits after the decimal point is equal to the
             precision specification.

             -                             If no precision is specified, ,
                                           six digits are output.

             -                             If the precision is zero, , no
                                           decimal point appears.

             -                             The E conversion character pro-
                                           duces a number with E instead of e
                                           before the exponent.  The exponent
                                           always contains at least two
                                           digits.  If the value is zero, the
                                           exponent is zero.

       g, G  : Accepts a real  and converts it in the style of the e, E, or f
             conversion characters, with the precision specifying the number
             of significant digits.  Trailing zeros are removed from the
             result.  A decimal point appears only if it is followed by a
             digit.  The style used depends on the value converted.  Style e
             (E, if G is the flag used) results only if the exponent result-
             ing from the conversion is less than -4, or if it is greater or
             equal to the precision.

       c     :Accepts and displays an integer value converted to a character.

       s     :Accepts a string value  and displays characters from the string
             to the end or the number of characters indicated by the preci-
             sion is reached.  If no precision is specified, all characters
             up to the end are displayed.
  A field width or precision can be indicated by an * (asterisk) instead of a
  digit string.  In this case, an integer value parameter supplies the field
  width or precision.  The value parameter converted for output is not
  fetched until the conversion letter is reached, so the parameters specify-
  ing field width or precision must appear before the value to be converted
  (if any).

  If the result of a conversion is wider than the field width, the field is
  expanded to contain the converted result.

  The representation of the plus sign depends on whether the + or (space)
  formatting option is specified.

SEE ALSO
  printf, fprintf, sprintf