Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (s) swprintf(3)
S or ls Accepts a pointer to an array of wchar_t type. Wide characters from the
array up to (but not including) the null character are printed. If a preci-
sion is specified, then no more than the number of bytes specified by the
precision are printed. If the precision is not specified or is greater than
the size of the array of bytes, then the array of wide characters must be
terminated by a null wide character. If a minimum field width is
specified and the array of bytes occupy fewer bytes than the specified
width, the array is padded with space characters to the specified width.
For TNS/E systems only, the behavior of ls is the same as the behavior of
S.
p Accepts a pointer to void. The value of the pointer is converted to a
sequence of printable characters, the same as unsigned hexadecimal
integer (x).
n Accepts a pointer to an integer into which is written the number of char-
acters written to the output stream so far by this call. No argument is
converted.
If the result of a conversion is wider than the field width, the field is expanded to contain the con-
verted result. No truncation occurs. However, a small precision can cause truncation on the
right.
The e, E, f, and g formats represent the special floating-point values as follows:
Quiet NaN NaN
Signaling NaN NaN
+/-INF +Inf or -Inf
+/-0 +0.0 or -0.0 (zero)
The representation of the + (plus sign) depends on whether the + or (space) formatting flag is
specified.
The swprintf( ) function allows for the insertion of a language-dependent radix character in the
output string. The radix character is defined by langinfo data in the program’s locale (category
LC_NUMERIC). In the C locale, or in a locale where the radix character is not defined, the
radix character defaults to . (period).
NOTES
This function supports both IEEE Std 754-1985 floating-point and Tandem floating-point values
in the native environment. IEEE values can include NaN and infinity, and the sign of 0.0 (zero)
can be either positive or negative. Refer to the fp_class(3) reference page for a description of
IEEE value classes.
Guardian functions are available to convert between floating-point formats. Refer to the Guar-
dian Programmer’s Guide for a discussion of floating-point conversions.
RETURN VALUES
Upon successful completion, this function returns the number of bytes in the output string. Oth-
erwise, a negative value is returned.
The value returned by the swprintf( ) function does not include the final ’\0’ (null) character.
527187-017 Hewlett-Packard Company 6−205