Content-type: text/html Man page of fputws

fputws

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

fputws - Writes a wide-character string to a stream  

LIBRARY

Standard C Library (libc.so, libc.a)  

SYNOPSIS

#include <wchar.h>

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

Application developers may want to specify an #include statement for <stdio.h> before the one for <wchar.h> if programs are being developed for multiple platforms. The additional #include statement is not required on Tru64 UNIX systems or by ISO or X/Open standards, but may be required on other vendors' systems that conform to these standards.  

STANDARDS

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

fputws(): XPG4, XPG4-UNIX

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 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. [XPG4-UNIX]  A physical I/O error occurred. 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


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:26 GMT, October 02, 2010