*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> fputws (3)              



NAME    [Toc]    [Back]

       fputws - Write a wide-character string to a stream

SYNOPSIS    [Toc]    [Back]

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

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

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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 filesize
 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.

SEE ALSO    [Toc]    [Back]

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

       Standards: standards(5)

[ Back ]
 Similar pages
Name OS Title
fputws Linux write a wide character string to a FILE stream
fputwc Tru64 Write a wide character to a stream
putwchar Tru64 Write a wide character to a stream
putwc Tru64 Write a wide character to a stream
fputwc Linux write a wide character to a FILE stream
fgetws Linux read a wide character string from a FILE stream
mbsrtowcs NetBSD converts a multibyte character string to a wide character string (restartable)
wcsrtombs NetBSD converts a wide character string to a multibyte character string (restartable)
wcsspn Linux advance in a wide-character string, skipping any of a set of wide characters
putwchar Linux write a wide character to standard output
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service