fputws_l(3) [osx man page]

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

fputws(3C)						   Standard C Library Functions 						fputws(3C)

NAME

       fputws - put wide character string on a stream

SYNOPSIS

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

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

DESCRIPTION

       The fputws() function writes a character string corresponding to the (null-terminated) wide character string pointed to by ws to the stream
       pointed to by stream. No character corresponding to the terminating null wide-character	code  is  written,  nor  is  a	NEWLINE  character
       appended.

       The st_ctime and st_mtime fields of the file will be marked for update between the successful execution of fputws() and the next successful
       completion of a call to fflush(3C) or fclose(3C) on the same stream or a call to exit(2) or abort(3C).

RETURN VALUES

       Upon successful completion, fputws() returns a non-negative value. Otherwise, it returns -1, sets an error indicator for  the  stream,  and
       sets errno to indicate the error.

ERRORS

       Refer to fputwc(3C).

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |ATTRIBUTE TYPE		     |ATTRIBUTE VALUE		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       exit(2), abort(3C), fclose(3C), fflush(3C), fopen(3C), fputwc(3C), attributes(5), standards(5)

SunOS 5.11							    1 Nov 2003								fputws(3C)