Index for Section 3

Alphabetical listing for F

Bottom of page

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 standards
  as follows:

  fputws(): XSH5.0

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

PARAMETERS
  wcs Points to a wide-character string to be written to output.

  stream
      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:

  [EAGAIN]
      The O_NONBLOCK option 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 writing.

  [EFBIG]
      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.

  [EINTR]
      The write operation was interrupted by a signal that was caught, and no
      data was transferred.

  [EIO]
      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.

  [EILSEQ]
      A wide character read from wcs does not correspond to a valid multibyte
      character in the current locale.

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

  [EPIPE]
      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)

Index for Section 3

Alphabetical listing for F

Top of page