OSF

NAME

wsprintf − Prints formatted output

LIBRARY

Standard I/O Package (libc.a)

SYNOPSIS

#include <stdio.h>

int wsprintf (
wchar_t ∗string,
char ∗format [, value, ... ] );

PARAMETERS

string Specifies a wchar_t string. 

format
Specifies a character string that contains plain characters, which are copied to the output stream, and conversion specifications, each of which causes zero or more items to be fetched from the value parameter list.  If there are not enough items for format in the value parameter list, the results are unpredictable.  If more values remain after the entire format has been processed, they are ignored. 

value Specifies the input to the format parameter. 

DESCRIPTION

The wsprintf() function is provided when Japanese Language Support is installed on your system. 

The wsprintf() function converts, formats, and stores its value parameters, under control of the format parameter, into consecutive wchar_t characters starting at the address specified by the string parameter.  The wsprintf() function places a ’ ’ (null character) at the end; It is your responsibility to ensure that enough storage space is available to contain the formatted string. The field width unit is specified as the number of wchar_t characters. 

The wsprintf() function is the same as the sprintf() function, except that the wsprintf function uses a wchar_t string. 

RETURN VALUES

Upon successful completion, the wsprintf() function returns the number of display characters in the output string rather than the number of bytes in the string. The wsprintf() function uses strings that can contain 2-byte wchars. The value returned by wsprintf does not include the final ’ ’ character. If an output error occurs, a negative value is returned. 

RELATED INFORMATION

Functions: conv(3), ecvt(3), printf(3), putc(3), putwc(3), scanf(3)