PRINTF(3W-SVR4)     RISC/os Reference Manual      PRINTF(3W-SVR4)



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
     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 charac-
     ter in the case of sprintf), or a negative value if an out-
     put 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 char-
     acters, 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 encoun-
          tered or the number of bytes indicated by the precision
          specification is printed.  If the precision specifica-
          tion is missing, it is taken to be infinite, and all
          wchar_t characters up to the first wchar_t null charac-
          ter 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.




                        Printed 11/19/92                   Page 1

PRINTF(3W-SVR4)     RISC/os Reference Manual      PRINTF(3W-SVR4)



     The ASCII space character (0x20) is used as a padding char-
     acters.

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

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












































 Page 2                 Printed 11/19/92