fgetwc man page on SmartOS

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

FGETWC(3C)							    FGETWC(3C)

       fgetwc - get a wide-character code from a stream

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

       wint_t fgetwc(FILE*stream);

       The  fgetwc() function obtains the next character (if present) from the
       input stream pointed to by stream, converts that to  the	 corresponding
       wide-character code and advances the associated file position indicator
       for the stream (if defined).

       If an error occurs, the resulting value of the file position  indicator
       for the stream is indeterminate.

       The  fgetwc()  function may mark the st_atime field of the file associ‐
       ated with stream for update. The st_atime  field	 will  be  marked  for
       update  by  the	first  successful  execution  of  fgetwc(), fgetc(3C),
       fgets(3C), fgetws(3C), fread(3C),  fscanf(3C),  getc(3C),  getchar(3C),
       gets(3C), or scanf(3C) using stream that returns data not supplied by a
       prior call to ungetc(3C) or ungetwc(3C).

       Upon successful completion the fgetwc() function returns the wide-char‐
       acter  code  of	the character read from the input stream pointed to by
       stream converted to a type wint_t.

       For standard-conforming (see standards(5)) applications, if the end-of-
       file  indicator for the stream is set, fgetwc() returns WEOF whether or
       not the stream is at end-of-file.

       If a read error occurs, the error indicator  for	 the  stream  is  set,
       fgetwc() returns WEOF and sets errno to indicate the error.

       If an encoding error occurs, the error indicator for the stream is set,
       fgetwc() returns WEOF, and errno is set to indicate the error.

       The fgetwc() function will fail if data needs to be read and:

		     The O_NONBLOCK flag is set for the file descriptor under‐
		     lying  stream  and	 the  process  would be delayed in the
		     fgetwc() operation.

		     The file descriptor underlying stream is not a valid file
		     descriptor open for reading.

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

		     A physical I/O error has occurred, or the process is in a
		     background process group attempting to read from its con‐
		     trolling terminal and either the process is  ignoring  or
		     blocking  the  SIGTTIN  signal  or	 the  process group is

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

       The fgetwc() function may fail if:

		 Insufficient storage space is available.

		 A request was made of a non-existent device, or  the  request
		 was outside the capabilities of the device.

		 The data obtained from the input stream does not form a valid

       The ferror(3C) or  feof(3C)  functions  must  be	 used  to  distinguish
       between an error condition and an end-of-file condition.

       See attributes(5) for descriptions of the following attributes:

       │CSI		    │ Enabled		      │
       │Interface Stability │ Standard		      │
       │MT-Level	    │ MT-Safe with exceptions │

       feof(3C),  ferror(3C),  fgetc(3C),  fgets(3C),  fgetws(3C),  fopen(3C),
       fread(3C), fscanf(3C), getc(3C), getchar(3C), gets(3C), scanf(3C), set‐
       locale(3C), ungetc(3C), ungetwc(3C), attributes(5), standards(5)

				 Oct 15, 2003			    FGETWC(3C)

List of man pages available for SmartOS

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]
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