This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

FPUTWS(3)                BSD Library Functions Manual                FPUTWS(3)

NAME
     fputws, fputws_l -- output a line of wide characters to a stream

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <stdio.h>
     #include <wchar.h>

     int
     fputws(const wchar_t *restrict ws, FILE *restrict stream);

     #include <stdio.h>
     #include <wchar.h>
     #include <xlocale.h>

     int
     fputws_l(const wchar_t *restrict ws, FILE *restrict stream, locale_t loc);

DESCRIPTION
     The fputws() function writes the wide character string pointed to by ws to the stream pointed to by
     stream.

     Although the fputws() function uses the current locale, the fputws_l() function may be passed a locale
     directly. See xlocale(3) for more information.

RETURN VALUES
     The fputws() function returns 0 on success and -1 on error.

ERRORS
     The fputws() function will fail if:

     [EBADF]            The stream argument supplied is not a writable stream.

     The fputws() function may also fail and set errno for any of the errors specified for the routine
     write(2).

SEE ALSO
     ferror(3), fputs(3), putwc(3), stdio(3), xlocale(3)

STANDARDS
     The fputws() function conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

BSD                             August 6, 2002                             BSD