/*
|
/*
|
* Copyright (c) 1990 The Regents of the University of California.
|
* Copyright (c) 1990 The Regents of the University of California.
|
* All rights reserved.
|
* All rights reserved.
|
*
|
*
|
* Redistribution and use in source and binary forms are permitted
|
* Redistribution and use in source and binary forms are permitted
|
* provided that the above copyright notice and this paragraph are
|
* provided that the above copyright notice and this paragraph are
|
* duplicated in all such forms and that any documentation,
|
* duplicated in all such forms and that any documentation,
|
* advertising materials, and other materials related to such
|
* advertising materials, and other materials related to such
|
* distribution and use acknowledge that the software was developed
|
* distribution and use acknowledge that the software was developed
|
* by the University of California, Berkeley. The name of the
|
* by the University of California, Berkeley. The name of the
|
* University may not be used to endorse or promote products derived
|
* University may not be used to endorse or promote products derived
|
* from this software without specific prior written permission.
|
* from this software without specific prior written permission.
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
|
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
|
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
*/
|
*/
|
|
|
/*
|
/*
|
FUNCTION
|
FUNCTION
|
<<sprintf>>, <<fprintf>>, <<printf>>, <<snprintf>>, <<asprintf>>, <<asnprintf>>---format output
|
<<sprintf>>, <<fprintf>>, <<printf>>, <<snprintf>>, <<asprintf>>, <<asnprintf>>---format output
|
|
|
INDEX
|
INDEX
|
fprintf
|
fprintf
|
INDEX
|
INDEX
|
_fprintf_r
|
_fprintf_r
|
INDEX
|
INDEX
|
printf
|
printf
|
INDEX
|
INDEX
|
_printf_r
|
_printf_r
|
INDEX
|
INDEX
|
asprintf
|
asprintf
|
INDEX
|
INDEX
|
_asprintf_r
|
_asprintf_r
|
INDEX
|
INDEX
|
sprintf
|
sprintf
|
INDEX
|
INDEX
|
_sprintf_r
|
_sprintf_r
|
INDEX
|
INDEX
|
snprintf
|
snprintf
|
INDEX
|
INDEX
|
_snprintf_r
|
_snprintf_r
|
INDEX
|
INDEX
|
asnprintf
|
asnprintf
|
INDEX
|
INDEX
|
_asnprintf_r
|
_asnprintf_r
|
|
|
ANSI_SYNOPSIS
|
ANSI_SYNOPSIS
|
#include <stdio.h>
|
#include <stdio.h>
|
|
|
int printf(const char *<[format]>, ...);
|
int printf(const char *<[format]>, ...);
|
int fprintf(FILE *<[fd]>, const char *<[format]>, ...);
|
int fprintf(FILE *<[fd]>, const char *<[format]>, ...);
|
int sprintf(char *<[str]>, const char *<[format]>, ...);
|
int sprintf(char *<[str]>, const char *<[format]>, ...);
|
int snprintf(char *<[str]>, size_t <[size]>, const char *<[format]>,
|
int snprintf(char *<[str]>, size_t <[size]>, const char *<[format]>,
|
...);
|
...);
|
int asprintf(char **<[strp]>, const char *<[format]>, ...);
|
int asprintf(char **<[strp]>, const char *<[format]>, ...);
|
char *asnprintf(char *<[str]>, size_t *<[size]>, const char *<[format]>,
|
char *asnprintf(char *<[str]>, size_t *<[size]>, const char *<[format]>,
|
...);
|
...);
|
|
|
int _printf_r(struct _reent *<[ptr]>, const char *<[format]>, ...);
|
int _printf_r(struct _reent *<[ptr]>, const char *<[format]>, ...);
|
int _fprintf_r(struct _reent *<[ptr]>, FILE *<[fd]>,
|
int _fprintf_r(struct _reent *<[ptr]>, FILE *<[fd]>,
|
const char *<[format]>, ...);
|
const char *<[format]>, ...);
|
int _sprintf_r(struct _reent *<[ptr]>, char *<[str]>,
|
int _sprintf_r(struct _reent *<[ptr]>, char *<[str]>,
|
const char *<[format]>, ...);
|
const char *<[format]>, ...);
|
int _snprintf_r(struct _reent *<[ptr]>, char *<[str]>, size_t <[size]>,
|
int _snprintf_r(struct _reent *<[ptr]>, char *<[str]>, size_t <[size]>,
|
const char *<[format]>, ...);
|
const char *<[format]>, ...);
|
int _asprintf_r(struct _reent *<[ptr]>, char **<[strp]>,
|
int _asprintf_r(struct _reent *<[ptr]>, char **<[strp]>,
|
const char *<[format]>, ...);
|
const char *<[format]>, ...);
|
char *_asnprintf_r(struct _reent *<[ptr]>, char *<[str]>,
|
char *_asnprintf_r(struct _reent *<[ptr]>, char *<[str]>,
|
size_t *<[size]>, const char *<[format]>, ...);
|
size_t *<[size]>, const char *<[format]>, ...);
|
|
|
DESCRIPTION
|
DESCRIPTION
|
<<printf>> accepts a series of arguments, applies to each a
|
<<printf>> accepts a series of arguments, applies to each a
|
format specifier from <<*<[format]>>>, and writes the
|
format specifier from <<*<[format]>>>, and writes the
|
formatted data to <<stdout>>, without a terminating NUL
|
formatted data to <<stdout>>, without a terminating NUL
|
character. The behavior of <<printf>> is undefined if there
|
character. The behavior of <<printf>> is undefined if there
|
are not enough arguments for the format. <<printf>> returns
|
are not enough arguments for the format. <<printf>> returns
|
when it reaches the end of the format string. If there are
|
when it reaches the end of the format string. If there are
|
more arguments than the format requires, excess arguments are
|
more arguments than the format requires, excess arguments are
|
ignored.
|
ignored.
|
|
|
<<fprintf>> is like <<printf>>, except that output is directed
|
<<fprintf>> is like <<printf>>, except that output is directed
|
to the stream <[fd]> rather than <<stdout>>.
|
to the stream <[fd]> rather than <<stdout>>.
|
|
|
<<sprintf>> is like <<printf>>, except that output is directed
|
<<sprintf>> is like <<printf>>, except that output is directed
|
to the buffer <[str]>, and a terminating NUL is output.
|
to the buffer <[str]>, and a terminating NUL is output.
|
Behavior is undefined if more output is generated than the
|
Behavior is undefined if more output is generated than the
|
buffer can hold.
|
buffer can hold.
|
|
|
<<snprintf>> is like <<sprintf>>, except that output is
|
<<snprintf>> is like <<sprintf>>, except that output is
|
limited to at most <[size]> bytes, including the terminating
|
limited to at most <[size]> bytes, including the terminating
|
<<NUL>>. As a special case, if <[size]> is 0, <[str]> can be
|
<<NUL>>. As a special case, if <[size]> is 0, <[str]> can be
|
NULL, and <<snprintf>> merely calculates how many bytes would
|
NULL, and <<snprintf>> merely calculates how many bytes would
|
be printed.
|
be printed.
|
|
|
<<asprintf>> is like <<sprintf>>, except that the output is
|
<<asprintf>> is like <<sprintf>>, except that the output is
|
stored in a dynamically allocated buffer, <[pstr]>, which
|
stored in a dynamically allocated buffer, <[pstr]>, which
|
should be freed later with <<free>>.
|
should be freed later with <<free>>.
|
|
|
<<asnprintf>> is like <<sprintf>>, except that the return type
|
<<asnprintf>> is like <<sprintf>>, except that the return type
|
is either the original <[str]> if it was large enough, or a
|
is either the original <[str]> if it was large enough, or a
|
dynamically allocated string if the output exceeds *<[size]>;
|
dynamically allocated string if the output exceeds *<[size]>;
|
the length of the result is returned in *<[size]>. When
|
the length of the result is returned in *<[size]>. When
|
dynamic allocation occurs, the contents of the original
|
dynamic allocation occurs, the contents of the original
|
<[str]> may have been modified.
|
<[str]> may have been modified.
|
|
|
For <<sprintf>>, <<snprintf>>, and <<asnprintf>>, the behavior
|
For <<sprintf>>, <<snprintf>>, and <<asnprintf>>, the behavior
|
is undefined if the output <<*<[str]>>> overlaps with one of
|
is undefined if the output <<*<[str]>>> overlaps with one of
|
the arguments. Behavior is also undefined if the argument for
|
the arguments. Behavior is also undefined if the argument for
|
<<%n>> within <<*<[format]>>> overlaps another argument.
|
<<%n>> within <<*<[format]>>> overlaps another argument.
|
|
|
<[format]> is a pointer to a character string containing two
|
<[format]> is a pointer to a character string containing two
|
types of objects: ordinary characters (other than <<%>>),
|
types of objects: ordinary characters (other than <<%>>),
|
which are copied unchanged to the output, and conversion
|
which are copied unchanged to the output, and conversion
|
specifications, each of which is introduced by <<%>>. (To
|
specifications, each of which is introduced by <<%>>. (To
|
include <<%>> in the output, use <<%%>> in the format string.)
|
include <<%>> in the output, use <<%%>> in the format string.)
|
A conversion specification has the following form:
|
A conversion specification has the following form:
|
|
|
. %[<[pos]>][<[flags]>][<[width]>][.<[prec]>][<[size]>]<[type]>
|
. %[<[pos]>][<[flags]>][<[width]>][.<[prec]>][<[size]>]<[type]>
|
|
|
The fields of the conversion specification have the following
|
The fields of the conversion specification have the following
|
meanings:
|
meanings:
|
|
|
O+
|
O+
|
o <[pos]>
|
o <[pos]>
|
|
|
Conversions normally consume arguments in the order that they
|
Conversions normally consume arguments in the order that they
|
are presented. However, it is possible to consume arguments
|
are presented. However, it is possible to consume arguments
|
out of order, and reuse an argument for more than one
|
out of order, and reuse an argument for more than one
|
conversion specification (although the behavior is undefined
|
conversion specification (although the behavior is undefined
|
if the same argument is requested with different types), by
|
if the same argument is requested with different types), by
|
specifying <[pos]>, which is a decimal integer followed by
|
specifying <[pos]>, which is a decimal integer followed by
|
'$'. The integer must be between 1 and <NL_ARGMAX> from
|
'$'. The integer must be between 1 and <NL_ARGMAX> from
|
limits.h, and if argument <<%n$>> is requested, all earlier
|
limits.h, and if argument <<%n$>> is requested, all earlier
|
arguments must be requested somewhere within <[format]>. If
|
arguments must be requested somewhere within <[format]>. If
|
positional parameters are used, then all conversion
|
positional parameters are used, then all conversion
|
specifications except for <<%%>> must specify a position.
|
specifications except for <<%%>> must specify a position.
|
|
|
o <[flags]>
|
o <[flags]>
|
|
|
<[flags]> is an optional sequence of characters which control
|
<[flags]> is an optional sequence of characters which control
|
output justification, numeric signs, decimal points, trailing
|
output justification, numeric signs, decimal points, trailing
|
zeros, and octal and hex prefixes. The flag characters are
|
zeros, and octal and hex prefixes. The flag characters are
|
minus (<<->>), plus (<<+>>), space ( ), zero (<<0>>), sharp
|
minus (<<->>), plus (<<+>>), space ( ), zero (<<0>>), sharp
|
(<<#>>), and quote (<<'>>). They can appear in any
|
(<<#>>), and quote (<<'>>). They can appear in any
|
combination, although not all flags can be used for all
|
combination, although not all flags can be used for all
|
conversion specification types.
|
conversion specification types.
|
|
|
o+
|
o+
|
o '
|
o '
|
Since newlib only supports the C locale, this
|
Since newlib only supports the C locale, this
|
flag has no effect in this implementation.
|
flag has no effect in this implementation.
|
But in other locales, when <[type]> is <<i>>,
|
But in other locales, when <[type]> is <<i>>,
|
<<d>>, <<u>>, <<f>>, <<F>>, <<g>>, or <<G>>,
|
<<d>>, <<u>>, <<f>>, <<F>>, <<g>>, or <<G>>,
|
the locale-dependent thousand's separator is
|
the locale-dependent thousand's separator is
|
inserted prior to zero padding.
|
inserted prior to zero padding.
|
|
|
o -
|
o -
|
The result of the conversion is left
|
The result of the conversion is left
|
justified, and the right is padded with
|
justified, and the right is padded with
|
blanks. If you do not use this flag, the
|
blanks. If you do not use this flag, the
|
result is right justified, and padded on the
|
result is right justified, and padded on the
|
left.
|
left.
|
|
|
o +
|
o +
|
The result of a signed conversion (as
|
The result of a signed conversion (as
|
determined by <[type]> of <<d>>, <<i>>, <<a>>,
|
determined by <[type]> of <<d>>, <<i>>, <<a>>,
|
<<A>>, <<e>>, <<E>>, <<f>>, <<F>>, <<g>>, or
|
<<A>>, <<e>>, <<E>>, <<f>>, <<F>>, <<g>>, or
|
<<G>>) will always begin with a plus or minus
|
<<G>>) will always begin with a plus or minus
|
sign. (If you do not use this flag, positive
|
sign. (If you do not use this flag, positive
|
values do not begin with a plus sign.)
|
values do not begin with a plus sign.)
|
|
|
o " " (space)
|
o " " (space)
|
If the first character of a signed conversion
|
If the first character of a signed conversion
|
specification is not a sign, or if a signed
|
specification is not a sign, or if a signed
|
conversion results in no characters, the
|
conversion results in no characters, the
|
result will begin with a space. If the space
|
result will begin with a space. If the space
|
( ) flag and the plus (<<+>>) flag both
|
( ) flag and the plus (<<+>>) flag both
|
appear, the space flag is ignored.
|
appear, the space flag is ignored.
|
|
|
o 0
|
o 0
|
If the <[type]> character is <<d>>, <<i>>,
|
If the <[type]> character is <<d>>, <<i>>,
|
<<o>>, <<u>>, <<x>>, <<X>>, <<a>>, <<A>>,
|
<<o>>, <<u>>, <<x>>, <<X>>, <<a>>, <<A>>,
|
<<e>>, <<E>>, <<f>>, <<g>>, or <<G>>: leading
|
<<e>>, <<E>>, <<f>>, <<g>>, or <<G>>: leading
|
zeros are used to pad the field width
|
zeros are used to pad the field width
|
(following any indication of sign or base); no
|
(following any indication of sign or base); no
|
spaces are used for padding. If the zero
|
spaces are used for padding. If the zero
|
(<<0>>) and minus (<<->>) flags both appear,
|
(<<0>>) and minus (<<->>) flags both appear,
|
the zero (<<0>>) flag will be ignored. For
|
the zero (<<0>>) flag will be ignored. For
|
<<d>>, <<i>>, <<o>>, <<u>>, <<x>>, and <<X>>
|
<<d>>, <<i>>, <<o>>, <<u>>, <<x>>, and <<X>>
|
conversions, if a precision <[prec]> is
|
conversions, if a precision <[prec]> is
|
specified, the zero (<<0>>) flag is ignored.
|
specified, the zero (<<0>>) flag is ignored.
|
|
|
Note that <<0>> is interpreted as a flag, not
|
Note that <<0>> is interpreted as a flag, not
|
as the beginning of a field width.
|
as the beginning of a field width.
|
|
|
o #
|
o #
|
The result is to be converted to an
|
The result is to be converted to an
|
alternative form, according to the <[type]>
|
alternative form, according to the <[type]>
|
character:
|
character:
|
|
|
o+
|
o+
|
o o
|
o o
|
Increases precision to force the first
|
Increases precision to force the first
|
digit of the result to be a zero.
|
digit of the result to be a zero.
|
|
|
o x
|
o x
|
A non-zero result will have a <<0x>>
|
A non-zero result will have a <<0x>>
|
prefix.
|
prefix.
|
|
|
o X
|
o X
|
A non-zero result will have a <<0X>>
|
A non-zero result will have a <<0X>>
|
prefix.
|
prefix.
|
|
|
o a, A, e, E, f, or F
|
o a, A, e, E, f, or F
|
The result will always contain a
|
The result will always contain a
|
decimal point even if no digits follow
|
decimal point even if no digits follow
|
the point. (Normally, a decimal point
|
the point. (Normally, a decimal point
|
appears only if a digit follows it.)
|
appears only if a digit follows it.)
|
Trailing zeros are removed.
|
Trailing zeros are removed.
|
|
|
o g or G
|
o g or G
|
The result will always contain a
|
The result will always contain a
|
decimal point even if no digits follow
|
decimal point even if no digits follow
|
the point. Trailing zeros are not
|
the point. Trailing zeros are not
|
removed.
|
removed.
|
|
|
o all others
|
o all others
|
Undefined.
|
Undefined.
|
|
|
o-
|
o-
|
o-
|
o-
|
|
|
o <[width]>
|
o <[width]>
|
|
|
<[width]> is an optional minimum field width. You can
|
<[width]> is an optional minimum field width. You can
|
either specify it directly as a decimal integer, or
|
either specify it directly as a decimal integer, or
|
indirectly by using instead an asterisk (<<*>>), in
|
indirectly by using instead an asterisk (<<*>>), in
|
which case an <<int>> argument is used as the field
|
which case an <<int>> argument is used as the field
|
width. If positional arguments are used, then the
|
width. If positional arguments are used, then the
|
width must also be specified positionally as <<*m$>>,
|
width must also be specified positionally as <<*m$>>,
|
with m as a decimal integer. Negative field widths
|
with m as a decimal integer. Negative field widths
|
are treated as specifying the minus (<<->>) flag for
|
are treated as specifying the minus (<<->>) flag for
|
left justfication, along with a positive field width.
|
left justfication, along with a positive field width.
|
The resulting format may be wider than the specified
|
The resulting format may be wider than the specified
|
width.
|
width.
|
|
|
o <[prec]>
|
o <[prec]>
|
|
|
<[prec]> is an optional field; if present, it is
|
<[prec]> is an optional field; if present, it is
|
introduced with `<<.>>' (a period). You can specify
|
introduced with `<<.>>' (a period). You can specify
|
the precision either directly as a decimal integer or
|
the precision either directly as a decimal integer or
|
indirectly by using an asterisk (<<*>>), in which case
|
indirectly by using an asterisk (<<*>>), in which case
|
an <<int>> argument is used as the precision. If
|
an <<int>> argument is used as the precision. If
|
positional arguments are used, then the precision must
|
positional arguments are used, then the precision must
|
also be specified positionally as <<*m$>>, with m as a
|
also be specified positionally as <<*m$>>, with m as a
|
decimal integer. Supplying a negative precision is
|
decimal integer. Supplying a negative precision is
|
equivalent to omitting the precision. If only a
|
equivalent to omitting the precision. If only a
|
period is specified the precision is zero. The effect
|
period is specified the precision is zero. The effect
|
depends on the conversion <[type]>.
|
depends on the conversion <[type]>.
|
|
|
o+
|
o+
|
o d, i, o, u, x, or X
|
o d, i, o, u, x, or X
|
Minimum number of digits to appear. If no
|
Minimum number of digits to appear. If no
|
precision is given, defaults to 1.
|
precision is given, defaults to 1.
|
|
|
o a or A
|
o a or A
|
Number of digits to appear after the decimal
|
Number of digits to appear after the decimal
|
point. If no precision is given, the
|
point. If no precision is given, the
|
precision defaults to the minimum needed for
|
precision defaults to the minimum needed for
|
an exact representation.
|
an exact representation.
|
|
|
o e, E, f or F
|
o e, E, f or F
|
Number of digits to appear after the decimal
|
Number of digits to appear after the decimal
|
point. If no precision is given, the
|
point. If no precision is given, the
|
precision defaults to 6.
|
precision defaults to 6.
|
|
|
o g or G
|
o g or G
|
Maximum number of significant digits. A
|
Maximum number of significant digits. A
|
precision of 0 is treated the same as a
|
precision of 0 is treated the same as a
|
precision of 1. If no precision is given, the
|
precision of 1. If no precision is given, the
|
precision defaults to 6.
|
precision defaults to 6.
|
|
|
o s or S
|
o s or S
|
Maximum number of characters to print from the
|
Maximum number of characters to print from the
|
string. If no precision is given, the entire
|
string. If no precision is given, the entire
|
string is printed.
|
string is printed.
|
|
|
o all others
|
o all others
|
undefined.
|
undefined.
|
|
|
o-
|
o-
|
|
|
o <[size]>
|
o <[size]>
|
|
|
<[size]> is an optional modifier that changes the data
|
<[size]> is an optional modifier that changes the data
|
type that the corresponding argument has. Behavior is
|
type that the corresponding argument has. Behavior is
|
unspecified if a size is given that does not match the
|
unspecified if a size is given that does not match the
|
<[type]>.
|
<[type]>.
|
|
|
o+
|
o+
|
o hh
|
o hh
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
<<X>>, specifies that the argument should be
|
<<X>>, specifies that the argument should be
|
converted to a <<signed char>> or <<unsigned
|
converted to a <<signed char>> or <<unsigned
|
char>> before printing.
|
char>> before printing.
|
|
|
With <<n>>, specifies that the argument is a
|
With <<n>>, specifies that the argument is a
|
pointer to a <<signed char>>.
|
pointer to a <<signed char>>.
|
|
|
o h
|
o h
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
<<X>>, specifies that the argument should be
|
<<X>>, specifies that the argument should be
|
converted to a <<short>> or <<unsigned short>>
|
converted to a <<short>> or <<unsigned short>>
|
before printing.
|
before printing.
|
|
|
With <<n>>, specifies that the argument is a
|
With <<n>>, specifies that the argument is a
|
pointer to a <<short>>.
|
pointer to a <<short>>.
|
|
|
o l
|
o l
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
<<X>>, specifies that the argument is a
|
<<X>>, specifies that the argument is a
|
<<long>> or <<unsigned long>>.
|
<<long>> or <<unsigned long>>.
|
|
|
With <<c>>, specifies that the argument has
|
With <<c>>, specifies that the argument has
|
type <<wint_t>>.
|
type <<wint_t>>.
|
|
|
With <<s>>, specifies that the argument is a
|
With <<s>>, specifies that the argument is a
|
pointer to <<wchar_t>>.
|
pointer to <<wchar_t>>.
|
|
|
With <<n>>, specifies that the argument is a
|
With <<n>>, specifies that the argument is a
|
pointer to a <<long>>.
|
pointer to a <<long>>.
|
|
|
With <<a>>, <<A>>, <<e>>, <<E>>, <<f>>, <<F>>,
|
With <<a>>, <<A>>, <<e>>, <<E>>, <<f>>, <<F>>,
|
<<g>>, or <<G>>, has no effect (because of
|
<<g>>, or <<G>>, has no effect (because of
|
vararg promotion rules, there is no need to
|
vararg promotion rules, there is no need to
|
distinguish between <<float>> and <<double>>).
|
distinguish between <<float>> and <<double>>).
|
|
|
o ll
|
o ll
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
<<X>>, specifies that the argument is a
|
<<X>>, specifies that the argument is a
|
<<long long>> or <<unsigned long long>>.
|
<<long long>> or <<unsigned long long>>.
|
|
|
With <<n>>, specifies that the argument is a
|
With <<n>>, specifies that the argument is a
|
pointer to a <<long long>>.
|
pointer to a <<long long>>.
|
|
|
o j
|
o j
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
<<X>>, specifies that the argument is an
|
<<X>>, specifies that the argument is an
|
<<intmax_t>> or <<uintmax_t>>.
|
<<intmax_t>> or <<uintmax_t>>.
|
|
|
With <<n>>, specifies that the argument is a
|
With <<n>>, specifies that the argument is a
|
pointer to an <<intmax_t>>.
|
pointer to an <<intmax_t>>.
|
|
|
o z
|
o z
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
<<X>>, specifies that the argument is a
|
<<X>>, specifies that the argument is a
|
<<ssize_t>> or <<size_t>>.
|
<<ssize_t>> or <<size_t>>.
|
|
|
With <<n>>, specifies that the argument is a
|
With <<n>>, specifies that the argument is a
|
pointer to a <<ssize_t>>.
|
pointer to a <<ssize_t>>.
|
|
|
o t
|
o t
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
With <<d>>, <<i>>, <<o>>, <<u>>, <<x>>, or
|
<<X>>, specifies that the argument is a
|
<<X>>, specifies that the argument is a
|
<<ptrdiff_t>>.
|
<<ptrdiff_t>>.
|
|
|
With <<n>>, specifies that the argument is a
|
With <<n>>, specifies that the argument is a
|
pointer to a <<ptrdiff_t>>.
|
pointer to a <<ptrdiff_t>>.
|
|
|
o L
|
o L
|
With <<a>>, <<A>>, <<e>>, <<E>>, <<f>>, <<F>>,
|
With <<a>>, <<A>>, <<e>>, <<E>>, <<f>>, <<F>>,
|
<<g>>, or <<G>>, specifies that the argument
|
<<g>>, or <<G>>, specifies that the argument
|
is a <<long double>>.
|
is a <<long double>>.
|
|
|
o-
|
o-
|
|
|
o <[type]>
|
o <[type]>
|
|
|
<[type]> specifies what kind of conversion <<printf>>
|
<[type]> specifies what kind of conversion <<printf>>
|
performs. Here is a table of these:
|
performs. Here is a table of these:
|
|
|
o+
|
o+
|
o %
|
o %
|
Prints the percent character (<<%>>).
|
Prints the percent character (<<%>>).
|
|
|
o c
|
o c
|
Prints <[arg]> as single character. If the
|
Prints <[arg]> as single character. If the
|
<<l>> size specifier is in effect, a multibyte
|
<<l>> size specifier is in effect, a multibyte
|
character is printed.
|
character is printed.
|
|
|
o C
|
o C
|
Short for <<%lc>>.
|
Short for <<%lc>>.
|
|
|
o s
|
o s
|
Prints the elements of a pointer to <<char>>
|
Prints the elements of a pointer to <<char>>
|
until the precision or a null character is
|
until the precision or a null character is
|
reached. If the <<l>> size specifier is in
|
reached. If the <<l>> size specifier is in
|
effect, the pointer is to an array of
|
effect, the pointer is to an array of
|
<<wchar_t>>, and the string is converted to
|
<<wchar_t>>, and the string is converted to
|
multibyte characters before printing.
|
multibyte characters before printing.
|
|
|
o S
|
o S
|
Short for <<%ls>>.
|
Short for <<%ls>>.
|
|
|
o d or i
|
o d or i
|
Prints a signed decimal integer; takes an
|
Prints a signed decimal integer; takes an
|
<<int>>. Leading zeros are inserted as
|
<<int>>. Leading zeros are inserted as
|
necessary to reach the precision. A precision
|
necessary to reach the precision. A precision
|
of 0 produces an empty string.
|
of 0 produces an empty string.
|
|
|
o D
|
o D
|
Newlib extension, short for <<%ld>>.
|
Newlib extension, short for <<%ld>>.
|
|
|
o o
|
o o
|
Prints an unsigned octal integer; takes an
|
Prints an unsigned octal integer; takes an
|
<<unsigned>>. Leading zeros are inserted as
|
<<unsigned>>. Leading zeros are inserted as
|
necessary to reach the precision. A precision
|
necessary to reach the precision. A precision
|
of 0 produces an empty string.
|
of 0 produces an empty string.
|
|
|
o O
|
o O
|
Newlib extension, short for <<%lo>>.
|
Newlib extension, short for <<%lo>>.
|
|
|
o u
|
o u
|
Prints an unsigned decimal integer; takes an
|
Prints an unsigned decimal integer; takes an
|
<<unsigned>>. Leading zeros are inserted as
|
<<unsigned>>. Leading zeros are inserted as
|
necessary to reach the precision. A precision
|
necessary to reach the precision. A precision
|
of 0 produces an empty string.
|
of 0 produces an empty string.
|
|
|
o U
|
o U
|
Newlib extension, short for <<%lu>>.
|
Newlib extension, short for <<%lu>>.
|
|
|
o x
|
o x
|
Prints an unsigned hexadecimal integer (using
|
Prints an unsigned hexadecimal integer (using
|
<<abcdef>> as digits beyond <<9>>); takes an
|
<<abcdef>> as digits beyond <<9>>); takes an
|
<<unsigned>>. Leading zeros are inserted as
|
<<unsigned>>. Leading zeros are inserted as
|
necessary to reach the precision. A precision
|
necessary to reach the precision. A precision
|
of 0 produces an empty string.
|
of 0 produces an empty string.
|
|
|
o X
|
o X
|
Like <<x>>, but uses <<ABCDEF>> as digits
|
Like <<x>>, but uses <<ABCDEF>> as digits
|
beyond <<9>>.
|
beyond <<9>>.
|
|
|
o f
|
o f
|
Prints a signed value of the form
|
Prints a signed value of the form
|
<<[-]9999.9999>>, with the precision
|
<<[-]9999.9999>>, with the precision
|
determining how many digits follow the decimal
|
determining how many digits follow the decimal
|
point; takes a <<double>> (remember that
|
point; takes a <<double>> (remember that
|
<<float>> promotes to <<double>> as a vararg).
|
<<float>> promotes to <<double>> as a vararg).
|
The low order digit is rounded to even. If
|
The low order digit is rounded to even. If
|
the precision results in at most DECIMAL_DIG
|
the precision results in at most DECIMAL_DIG
|
digits, the result is rounded correctly; if
|
digits, the result is rounded correctly; if
|
more than DECIMAL_DIG digits are printed, the
|
more than DECIMAL_DIG digits are printed, the
|
result is only guaranteed to round back to the
|
result is only guaranteed to round back to the
|
original value.
|
original value.
|
|
|
If the value is infinite, the result is
|
If the value is infinite, the result is
|
<<inf>>, and no zero padding is performed. If
|
<<inf>>, and no zero padding is performed. If
|
the value is not a number, the result is
|
the value is not a number, the result is
|
<<nan>>, and no zero padding is performed.
|
<<nan>>, and no zero padding is performed.
|
|
|
o F
|
o F
|
Like <<f>>, but uses <<INF>> and <<NAN>> for
|
Like <<f>>, but uses <<INF>> and <<NAN>> for
|
non-finite numbers.
|
non-finite numbers.
|
|
|
o e
|
o e
|
Prints a signed value of the form
|
Prints a signed value of the form
|
<<[-]9.9999e[+|-]999>>; takes a <<double>>.
|
<<[-]9.9999e[+|-]999>>; takes a <<double>>.
|
The digit before the decimal point is non-zero
|
The digit before the decimal point is non-zero
|
if the value is non-zero. The precision
|
if the value is non-zero. The precision
|
determines how many digits appear between
|
determines how many digits appear between
|
<<.>> and <<e>>, and the exponent always
|
<<.>> and <<e>>, and the exponent always
|
contains at least two digits. The value zero
|
contains at least two digits. The value zero
|
has an exponent of zero. If the value is not
|
has an exponent of zero. If the value is not
|
finite, it is printed like <<f>>.
|
finite, it is printed like <<f>>.
|
|
|
o E
|
o E
|
Like <<e>>, but using <<E>> to introduce the
|
Like <<e>>, but using <<E>> to introduce the
|
exponent, and like <<F>> for non-finite
|
exponent, and like <<F>> for non-finite
|
values.
|
values.
|
|
|
o g
|
o g
|
Prints a signed value in either <<f>> or <<e>>
|
Prints a signed value in either <<f>> or <<e>>
|
form, based on the given value and
|
form, based on the given value and
|
precision---an exponent less than -4 or
|
precision---an exponent less than -4 or
|
greater than the precision selects the <<e>>
|
greater than the precision selects the <<e>>
|
form. Trailing zeros and the decimal point
|
form. Trailing zeros and the decimal point
|
are printed only if necessary; takes a
|
are printed only if necessary; takes a
|
<<double>>.
|
<<double>>.
|
|
|
o G
|
o G
|
Like <<g>>, except use <<F>> or <<E>> form.
|
Like <<g>>, except use <<F>> or <<E>> form.
|
|
|
o a
|
o a
|
Prints a signed value of the form
|
Prints a signed value of the form
|
<<[-]0x1.ffffp[+|-]9>>; takes a <<double>>.
|
<<[-]0x1.ffffp[+|-]9>>; takes a <<double>>.
|
The letters <<abcdef>> are used for digits
|
The letters <<abcdef>> are used for digits
|
beyond <<9>>. The precision determines how
|
beyond <<9>>. The precision determines how
|
many digits appear after the decimal point.
|
many digits appear after the decimal point.
|
The exponent contains at least one digit, and
|
The exponent contains at least one digit, and
|
is a decimal value representing the power of
|
is a decimal value representing the power of
|
2; a value of 0 has an exponent of 0.
|
2; a value of 0 has an exponent of 0.
|
Non-finite values are printed like <<f>>.
|
Non-finite values are printed like <<f>>.
|
|
|
o A
|
o A
|
Like <<a>>, except uses <<X>>, <<P>>, and
|
Like <<a>>, except uses <<X>>, <<P>>, and
|
<<ABCDEF>> instead of lower case.
|
<<ABCDEF>> instead of lower case.
|
|
|
o n
|
o n
|
Takes a pointer to <<int>>, and stores a count
|
Takes a pointer to <<int>>, and stores a count
|
of the number of bytes written so far. No
|
of the number of bytes written so far. No
|
output is created.
|
output is created.
|
|
|
o p
|
o p
|
Takes a pointer to <<void>>, and prints it in
|
Takes a pointer to <<void>>, and prints it in
|
an implementation-defined format. This
|
an implementation-defined format. This
|
implementation is similar to <<%#tx>>), except
|
implementation is similar to <<%#tx>>), except
|
that <<0x>> appears even for the NULL pointer.
|
that <<0x>> appears even for the NULL pointer.
|
|
|
o-
|
o-
|
O-
|
O-
|
|
|
<<_printf_r>>, <<_fprintf_r>>, <<_asprintf_r>>,
|
<<_printf_r>>, <<_fprintf_r>>, <<_asprintf_r>>,
|
<<_sprintf_r>>, <<_snprintf_r>>, <<_asnprintf_r>> are simply
|
<<_sprintf_r>>, <<_snprintf_r>>, <<_asnprintf_r>> are simply
|
reentrant versions of the functions above.
|
reentrant versions of the functions above.
|
|
|
RETURNS
|
RETURNS
|
On success, <<sprintf>> and <<asprintf>> return the number of bytes in
|
On success, <<sprintf>> and <<asprintf>> return the number of bytes in
|
the output string, except the concluding <<NUL>> is not counted.
|
the output string, except the concluding <<NUL>> is not counted.
|
<<snprintf>> returns the number of bytes that would be in the output
|
<<snprintf>> returns the number of bytes that would be in the output
|
string, except the concluding <<NUL>> is not counted. <<printf>> and
|
string, except the concluding <<NUL>> is not counted. <<printf>> and
|
<<fprintf>> return the number of characters transmitted.
|
<<fprintf>> return the number of characters transmitted.
|
<<asnprintf>> returns the original <[str]> if there was enough room,
|
<<asnprintf>> returns the original <[str]> if there was enough room,
|
otherwise it returns an allocated string.
|
otherwise it returns an allocated string.
|
|
|
If an error occurs, the result of <<printf>>, <<fprintf>>,
|
If an error occurs, the result of <<printf>>, <<fprintf>>,
|
<<snprintf>>, and <<asprintf>> is a negative value, and the result of
|
<<snprintf>>, and <<asprintf>> is a negative value, and the result of
|
<<asnprintf>> is NULL. No error returns occur for <<sprintf>>. For
|
<<asnprintf>> is NULL. No error returns occur for <<sprintf>>. For
|
<<printf>> and <<fprintf>>, <<errno>> may be set according to
|
<<printf>> and <<fprintf>>, <<errno>> may be set according to
|
<<fputc>>. For <<asprintf>> and <<asnprintf>>, <<errno>> may be set
|
<<fputc>>. For <<asprintf>> and <<asnprintf>>, <<errno>> may be set
|
to ENOMEM if allocation fails, and for <<snprintf>>, <<errno>> may be
|
to ENOMEM if allocation fails, and for <<snprintf>>, <<errno>> may be
|
set to EOVERFLOW if <[size]> or the output length exceeds INT_MAX.
|
set to EOVERFLOW if <[size]> or the output length exceeds INT_MAX.
|
|
|
PORTABILITY
|
PORTABILITY
|
ANSI C requires <<printf>>, <<fprintf>>, <<sprintf>>, and
|
ANSI C requires <<printf>>, <<fprintf>>, <<sprintf>>, and
|
<<snprintf>>. <<asprintf>> and <<asnprintf>> are newlib extensions.
|
<<snprintf>>. <<asprintf>> and <<asnprintf>> are newlib extensions.
|
|
|
The ANSI C standard specifies that implementations must support at
|
The ANSI C standard specifies that implementations must support at
|
least formatted output of up to 509 characters. This implementation
|
least formatted output of up to 509 characters. This implementation
|
has no inherent limit.
|
has no inherent limit.
|
|
|
Depending on how newlib was configured, not all format specifiers are
|
Depending on how newlib was configured, not all format specifiers are
|
supported.
|
supported.
|
|
|
Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>,
|
Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>,
|
<<lseek>>, <<read>>, <<sbrk>>, <<write>>.
|
<<lseek>>, <<read>>, <<sbrk>>, <<write>>.
|
*/
|
*/
|
|
|
#include <_ansi.h>
|
#include <_ansi.h>
|
#include <reent.h>
|
#include <reent.h>
|
#include <stdio.h>
|
#include <stdio.h>
|
#ifdef _HAVE_STDC
|
#ifdef _HAVE_STDC
|
#include <stdarg.h>
|
#include <stdarg.h>
|
#else
|
#else
|
#include <varargs.h>
|
#include <varargs.h>
|
#endif
|
#endif
|
#include <limits.h>
|
#include <limits.h>
|
#include "local.h"
|
#include "local.h"
|
|
|
int
|
int
|
#ifdef _HAVE_STDC
|
#ifdef _HAVE_STDC
|
_DEFUN(_sprintf_r, (ptr, str, fmt),
|
_DEFUN(_sprintf_r, (ptr, str, fmt),
|
struct _reent *ptr _AND
|
struct _reent *ptr _AND
|
char *str _AND
|
char *str _AND
|
_CONST char *fmt _DOTS)
|
_CONST char *fmt _DOTS)
|
#else
|
#else
|
_sprintf_r(ptr, str, fmt, va_alist)
|
_sprintf_r(ptr, str, fmt, va_alist)
|
struct _reent *ptr;
|
struct _reent *ptr;
|
char *str;
|
char *str;
|
_CONST char *fmt;
|
_CONST char *fmt;
|
va_dcl
|
va_dcl
|
#endif
|
#endif
|
{
|
{
|
int ret;
|
int ret;
|
va_list ap;
|
va_list ap;
|
FILE f;
|
FILE f;
|
|
|
f._flags = __SWR | __SSTR;
|
f._flags = __SWR | __SSTR;
|
f._bf._base = f._p = (unsigned char *) str;
|
f._bf._base = f._p = (unsigned char *) str;
|
f._bf._size = f._w = INT_MAX;
|
f._bf._size = f._w = INT_MAX;
|
f._file = -1; /* No file. */
|
f._file = -1; /* No file. */
|
#ifdef _HAVE_STDC
|
#ifdef _HAVE_STDC
|
va_start (ap, fmt);
|
va_start (ap, fmt);
|
#else
|
#else
|
va_start (ap);
|
va_start (ap);
|
#endif
|
#endif
|
ret = _svfprintf_r (ptr, &f, fmt, ap);
|
ret = _svfprintf_r (ptr, &f, fmt, ap);
|
va_end (ap);
|
va_end (ap);
|
*f._p = 0;
|
*f._p = 0;
|
return (ret);
|
return (ret);
|
}
|
}
|
|
|
#ifndef _REENT_ONLY
|
#ifndef _REENT_ONLY
|
|
|
int
|
int
|
#ifdef _HAVE_STDC
|
#ifdef _HAVE_STDC
|
_DEFUN(sprintf, (str, fmt),
|
_DEFUN(sprintf, (str, fmt),
|
char *str _AND
|
char *str _AND
|
_CONST char *fmt _DOTS)
|
_CONST char *fmt _DOTS)
|
#else
|
#else
|
sprintf(str, fmt, va_alist)
|
sprintf(str, fmt, va_alist)
|
char *str;
|
char *str;
|
_CONST char *fmt;
|
_CONST char *fmt;
|
va_dcl
|
va_dcl
|
#endif
|
#endif
|
{
|
{
|
int ret;
|
int ret;
|
va_list ap;
|
va_list ap;
|
FILE f;
|
FILE f;
|
|
|
f._flags = __SWR | __SSTR;
|
f._flags = __SWR | __SSTR;
|
f._bf._base = f._p = (unsigned char *) str;
|
f._bf._base = f._p = (unsigned char *) str;
|
f._bf._size = f._w = INT_MAX;
|
f._bf._size = f._w = INT_MAX;
|
f._file = -1; /* No file. */
|
f._file = -1; /* No file. */
|
#ifdef _HAVE_STDC
|
#ifdef _HAVE_STDC
|
va_start (ap, fmt);
|
va_start (ap, fmt);
|
#else
|
#else
|
va_start (ap);
|
va_start (ap);
|
#endif
|
#endif
|
ret = _svfprintf_r (_REENT, &f, fmt, ap);
|
ret = _svfprintf_r (_REENT, &f, fmt, ap);
|
va_end (ap);
|
va_end (ap);
|
*f._p = 0;
|
*f._p = 0;
|
return (ret);
|
return (ret);
|
}
|
}
|
|
|
#endif
|
#endif
|
|
|
