fputws(3c) [opensolaris man page]

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)

fputws(3)						     Library Functions Manual							 fputws(3)

NAME

       fputws - Writes a wide-character string to a stream

LIBRARY

       Standard C Library (libc)

SYNOPSIS

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

       int fputws(	const wchar_t *wcs,	 FILE *stream);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       fputws(): XSH5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Points to a wide-character string to be written to output.  Points to the FILE structure of an open file.

DESCRIPTION

       The  fputws() function reads the wchar_t string pointed to by the wcs parameter, converts each wide character to a multibyte character, and
       writes the result to the output stream pointed to by the stream parameter. The function does not append a newline  or  a  terminating  null
       character to the result.

       The fputws() function parallels the fputs() function.

       The  st_ctime  and st_mtime fields of the file are marked for update between the successful execution of the fputws() function and the next
       successful completion of a call to the fflush() or fclose() function on the same stream, or a call to the exit() or abort() function.

RETURN VALUES

       On successful completion, the fputws() function returns a non-negative number to indicate the number of bytes written to the output stream.
       Otherwise, the function returns -1, sets the error indicator for the stream, and sets errno to indicate the error.

ERRORS

       If  any	of the following conditions occur, the fputws() function sets errno to the corresponding value: The O_NONBLOCK flag is set for the
       file descriptor underlying stream and the process would be delayed in the write operation.  The file descriptor underlying stream is not  a
       valid  file  descriptor open for writing.  An attempt was made to write to a file that exceeds the process's file-size limit or the maximum
       file size.

	      The file is a regular file and an attempt was made to write at or beyond	the  offset  maximum  associated  with	the  corresponding
	      stream.	The write operation was interrupted by a signal that was caught, and no data was transferred.  One of the following errors
	      was encountered: The process is a member of a background process group attempting to write to its controlling terminal and TOSTOP is
	      set;  the  process  is neither ignoring nor blocking SIGTTOU and the process group of the process is orphaned.  A physical I/O error
	      occurred. This condition is defined starting with Issue 4 Version 2 and later revisions of the XSH specification.  A wide  character
	      read  from  wcs  does not correspond to a valid multibyte character in the current locale.  There was no free space remaining on the
	      device containing the file.  An attempt was made to write to a pipe or FIFO that is not open for reading by any process.	A  SIGPIPE
	      signal will also be sent to the process.

RELATED INFORMATION

       Functions: fgetws(3), gets(3), wcstombs(3), printf(3), putc(3), puts(3), putwc(3), wprintf(3)

       Standards: standards(5) delim off

																	 fputws(3)