fgetws man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

fgetws(3C)							    fgetws(3C)

       fgetws(), fgetws_unlocked() - get a wide-character string from a stream

   Obsolescent Interface
       is compliant with the XPG4 Worldwide Portability Interface wide-charac‐
       ter  I/O	 functions.   It  parallels  the  8-bit character I/O function
       defined in gets(3S).

       Reads characters from the
		      stream, converts them into  corresponding	 wide  charac‐
		      ters,  and  places them into the array pointed to by ws,
		      until n − 1 characters are read, a newline character  is
		      read  and transferred to ws, or an end-of-file condition
		      is encountered.  The wide string is then terminated with
		      a null wide character.

       The  definition	for  this  functions  and the type are provided in the

   Obsolescent Interface
       get a wide-character string from a stream file.

       After is applied to a stream, the  stream  becomes  wide-oriented  (see

   Environment Variables
       determines how wide character conversions are done.

   International Code Set Support
       Single- and multibyte character code sets are supported.

       Upon successful completion, and return ws.  If the stream is at end-of-
       file, the end-of-file indicator for  the	 stream	 is  set  and  a  null
       pointer is returned.

       When  the file corresponding to the open stream gets extended after the
       end-of-file is reached, all subsequent calls to	these  functions  will
       succeed and the end-of-file indicator will remain set.  However, in the
       UNIX2003 standards environment (see standards(5)), these functions will
       fail,  and  they	 will return a null pointer; the end-of-file indicator
       will still remain set.

       If a read error occurs, the error indicator for the stream is  set,  is
       set to indicate the error, and a null pointer is returned.

       or can be used to distinguish between an error condition and an end-of-
       file condition.

       If or fails if data needs to be	read  into  the	 stream's  buffer  and
       another error occurs, is set to one of the following:

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

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

	      The read operation was terminated due to the receipt of  a  sig‐
			     and  either no data was transferred or the imple‐
			     mentation does not report	partial	 transfer  for
			     this file.

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

	      The process is a member of a background process
			     and is attempting to read	from  its  controlling
			     terminal,	and  either the process is ignoring or
			     blocking the signal or the process group  of  the
			     process is orphaned.

       Additional values can be set by the underlying function (see read(2)).

       is  an  obsolescent  interface  supported  only	for compatibility with
       existing DCE applications.  New multithreaded applications should use

       was developed by OSF and HP.

       ferror(3S), flockfile(3S), fopen(3S), fread(3S), getwc(3C),  putws(3C),
       scanf(3S), orientation(5), standards(5), thread_safety(5), glossary(9).


List of man pages available for HP-UX

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