fputws man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

fputws(3)							     fputws(3)

NAME
       fputws - Write a wide-character string to a stream

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

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

LIBRARY
       Standard C Library (libc)

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards 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 parame‐
       ter. The function does not append a newline or a terminating null char‐
       acter 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 option 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 specifica‐
	      tion.  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.

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

       Standards: standards(5)

								     fputws(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net