manpagez: man (manual) pages & more
man fputws(3)
Home | html | info | man
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 infor-
     mation.


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

Mac OS X 10.8 - Generated Mon Aug 27 18:28:27 CDT 2012