NAME

printf, fprintf, sprintf − print formatted output

SYNOPSIS

#include <stdio.h>
#include <widec.h> int printf (const char ∗format [, arg] ... ); int fprintf (FILE ∗stream, const char ∗format [, arg] ... ); int sprintf (char ∗s, const char ∗format [, arg] ... );

DESCRIPTION (International Functions)

printf() places output on the standard output stream stdout.  fprintf() places output on the named output stream.  sprintf() places output followed by the NULL character in a character array pointed to by s.  Each function returns the number of bytes transmitted (not including the NULL character in the case of sprintf), or a negative value if an output error was encountered. 

Each of these functions converts, formats and prints its args under control of the format.  The format is a character string that contains two types of object: plain characters, including ASCII characters and characters in supplementary code sets which are simply copied to the output stream, and conversion specifications which can contain only ASCII characters, each of which results in the fetching of zero or more args. 

wc and ws are the new conversion specifications for wchar_t character control.  Both wc and ws may be used in all three functions. 

wc The wchar_t character arg is transformed into EUC, and then printed.  If a field width is specified and the transformed EUC has fewer bytes than the field width, it will by padded to the given width.  A precision specification is ignored, if specified. 

ws The arg is taken to be a wchar_t string and the wchar_t characters from the string are transformed into EUC, and printed until a wchar_t null character is encountered or the number of bytes indicated by the precision specification is printed.  If the precision specification is missing, it is taken to be infinite, and all wchar_t characters up to the first wchar_t null character are transformed into EUC and printed.  If a field width is specified and the transformed EUC have fewer bytes than the field width, they are padded to the given width. 

The ASCII space character (0x20) is used as a padding characters. 

DIAGNOSTICS

printf, fprintf, and sprintf returns the number of bytes transmitted, or return a negative value if an error was encountered. 

SEE ALSO

printf(3S), scanf(3W), stdio(3S), vprintf(3W), widec(3W).