👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

Linux 2.6 - man page for fputwc (linux section 3posix)

FPUTWC(P)			    POSIX Programmer's Manual				FPUTWC(P)

NAME
       fputwc - put a wide-character code on a stream

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

       wint_t fputwc(wchar_t wc, FILE *stream);

DESCRIPTION
       The  fputwc()  function shall write the character corresponding to the wide-character code
       wc to the output stream pointed to by stream, at the position indicated by the  associated
       file-position  indicator for the stream (if defined), and advances the indicator appropri-
       ately. If the file cannot support positioning requests, or if the stream was  opened  with
       append  mode,  the  character  is  appended to the output stream. If an error occurs while
       writing the character, the shift state of the output file is left in an undefined state.

       The st_ctime and st_mtime fields of the file shall be marked for update between	the  suc-
       cessful	execution of fputwc() and the next successful completion of a call to fflush() or
       fclose() on the same stream or a call to exit() or abort().

RETURN VALUE
       Upon successful completion, fputwc() shall return wc.  Otherwise, it  shall  return  WEOF,
       the error indicator for the stream shall be set,    and errno shall be set to indicate the
       error.

ERRORS
       The fputwc() function shall fail if either  the	stream	is  unbuffered	or  data  in  the
       stream's buffer needs to be written, and:

       EAGAIN The  O_NONBLOCK  flag  is  set  for  the	file descriptor underlying stream and the
	      process would be delayed in the write operation.

       EBADF  The file descriptor underlying stream is not a valid file descriptor open for writ-
	      ing.

       EFBIG  An  attempt  was	made to write to a file that exceeds the maximum file size or the
	      process' file size limit.

       EFBIG  The file is a regular file and an attempt was made to write at or beyond the offset
	      maximum associated with the corresponding stream.

       EILSEQ The wide-character code wc does not correspond to a valid character.

       EINTR  The  write operation was terminated due to the receipt of a signal, and no data was
	      transferred.

       EIO    A physical I/O error has occurred, or the process  is  a	member	of  a  background
	      process  group  attempting to write to its controlling terminal, TOSTOP is set, the
	      process is neither ignoring nor blocking SIGTTOU, and  the  process  group  of  the
	      process  is orphaned.  This error may also be returned under implementation-defined
	      conditions.

       ENOSPC There was no free space remaining on the device containing the file.

       EPIPE  An attempt is made to write to a pipe or FIFO that is not open for reading  by  any
	      process. A SIGPIPE signal shall also be sent to the thread.

       The fputwc() function may fail if:

       ENOMEM Insufficient storage space is available.

       ENXIO  A request was made of a nonexistent device, or the request was outside the capabil-
	      ities of the device.

       The following sections are informative.

EXAMPLES
       None.

APPLICATION USAGE
       None.

RATIONALE
       None.

FUTURE DIRECTIONS
       None.

SEE ALSO
       ferror()  ,  fopen()  ,	setbuf()  ,  ulimit()  ,   the	 Base	Definitions   volume   of
       IEEE Std 1003.1-2001, <stdio.h>, <wchar.h>

COPYRIGHT
       Portions  of  this  text  are  reprinted  and  reproduced in electronic form from IEEE Std
       1003.1, 2003 Edition, Standard for Information Technology  --  Portable	Operating  System
       Interface  (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2003 by
       the Institute of Electrical and Electronics Engineers, Inc and  The  Open  Group.  In  the
       event  of  any  discrepancy  between this version and the original IEEE and The Open Group
       Standard, the original IEEE and The Open Group Standard is the referee document. The orig-
       inal Standard can be obtained online at http://www.opengroup.org/unix/online.html .

IEEE/The Open Group			       2003					FPUTWC(P)


All times are GMT -4. The time now is 01:59 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password