HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

131

132

133

134

135

136

137

138

139

140

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/nan.3m

________________________________________________________________

___ ___

printf(3S) printf(3S)

c The integer arg is converted to an unsigned char, and the resulting character is

printed. If an l (ell) qualiﬁer is present, the wchar_t arg is converted to an array

of bytes representing the single wide character according to the setting of LC_CTYPE.

Resulting bytes are printed. If the ﬁeld width would otherwise cause the wide charac-

ter to be split, the wide character is printed and the ﬁeld width is adjusted upward.

_INCLUDE__STDC_A1_SOURCE only

If an l (ell) qualiﬁer is present, the wint_t argument is converted as if by an ls

conversion speciﬁcation with no precision and an argument that points to a two-

element array of type wchar_t, the ﬁrst element of which contains the wint_t

argument to the ls conversion speciﬁcation and the second element contains a null

wide-character.

C Same as lc.

s The arg is taken to be a string (character pointer) and characters from the string are

printed until a null character (\0) is encountered or the number of bytes indicated by

the precision speciﬁcation is reached. If the precision is missing, it is taken to be

inﬁnite, so all characters up to the ﬁrst null character are printed. A NULL value for

arg yields undeﬁned results.

If an l (ell) qualiﬁer is present, the argument must be a pointer to an array of type

wchar_t. Wide-characters from the array are converted to characters (each as if by

a call to the wcrtomb() function, with the conversion state described by an

mbstate_t object initialized to zero before the ﬁrst wide-character is converted) up

to and including a terminating null wide-character. The resulting characters are writ-

ten up to (but not including) the terminating null character (byte).

If no precision is speciﬁed, the array must contain a null wide-character. If a preci-

sion is speciﬁed, no more than that many characters (bytes) are written (including

shift sequences, if any), and the array must contain a null wide-character if, to equal

the character sequence length given by the precision, the function would need to

access a wide-character one past the end of the array. In no case is a partial character

written.

S Same as ls.

p The value of a pointer to void arg is printed as a sequence of unsigned hexadecimal

numbers. The precision speciﬁes 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 preci-

sion of zero is a null string.

n A pointer to an integer arg is expected. This pointer is used to store the number of

bytes printed on the output stream so far by this call to the function. No argument is

converted.

% Print a %; no argument is converted. The entire conversion speciﬁcation must be %%.

In no case does a nonexistent or small ﬁeld width cause truncation of a ﬁeld; if the result of a conversion is

wider than the ﬁeld width, the ﬁeld is expanded to contain the conversion result.

The e, f, and g conversions will print inf for inﬁnity and nan

for both quiet and signaling NaN values.

The

E and G conversions will print INF for inﬁnity and NAN for both quiet and signaling

NaN values.

There will be a new

F conversion speciﬁer that will be identical to the f

conversion speciﬁer except that it

will print inﬁnity and NaN as respectively,

INF and NAN.

Characters generated by printf() and fprintf() are printed as if putc() had been called (see

putc(3S)).

APPLICATION USAGE

printf(), fprintf(), sprintf() and snprintf() are thread-safe. These interfaces are not

async-cancel-safe. A cancellation point may occur when a thread is executing printf() or fprintf() .

To use

_INCLUDE__STDC_A1_SOURCE

functionality, the _INCLUDE__STDC_A1_SOURCE

ﬂag must

be passed as a compiler option or deﬁned as a macro in source ﬁles.

Section 3−−628 − 3 − HP-UX Release 11i: December 2000

___