Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (t - z) vswprintf(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.
This 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
In the TNS environment, the vswprintf() function supports only the C/POSIX locale. Thus, any
conversion specifications that are locale-dependent do not function correctly in locales other than
the C/POSIX locale. In the native environment, the vswprintf() function supports all locales.
RETURN VALUES
Upon successful completion, this function returns the number of bytes in the output string. Oth-
erwise, a negative value is returned.
ERRORS
None. The vswprintf() function does not set errno.
RELATED INFORMATION
Functions: fprintf(3), printf(3), sprintf(3), vfprintf(3), vprintf(3).
527192-018 Hewlett-Packard Company 7−115