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

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

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##include <>
     ##include <>

     int
     fputws(const wchart * restrict ws, FILE * restrict fp);

     ##include <>

     int
     fputwsl(const wchart * restrict ws, FILE * restrict fp, localet loc);

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

     While the fputws() function uses the current locale, the fputwsl() func-
     tion may be passed a locale directly. See xlocale(3) for more informa-
     tion.

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

ERORS
     The fputws() function will fail if:

     [EBADF]            The fp 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 IE Std 1003.1-2001 (``POSIX.1'').

BSD                             August 6, 2002                             BSD