Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for fgetws (redhat section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

FGETWS(3)			    Linux Programmer's Manual				FGETWS(3)

       fgetws - read a wide character string from a FILE stream

       #include <wchar.h>

       wchar_t *fgetws(wchar_t *ws, int n, FILE *stream);

       The  fgetws  function  is  the wide-character equivalent of the fgets function. It reads a
       string of at most n-1 wide characters into the wide-character array pointed to by ws,  and
       adds  a terminating L'\0' character. It stops reading wide characters after it has encoun-
       tered and stored a newline wide character. It also stops when end of stream is reached.

       The programmer must ensure that there is room for at least n wide characters at ws.

       For a non-locking counterpart, see unlocked_stdio(3).

       The fgetws function, if successful, returns ws. If end of stream was already reached or if
       an error occurred, it returns NULL.

       ISO/ANSI C, UNIX98

       The behaviour of fgetws depends on the LC_CTYPE category of the current locale.

       In  the	absence  of  additional information passed to the fopen call, it is reasonable to
       expect that fgetws will actually read a multibyte string from the stream and then  convert
       it to a wide character string.

       This  function  is  unreliable, because it does not permit to deal properly with null wide
       characters that may be present in the input.

       fgetwc(3) unlocked_stdio(3)

GNU					    1999-07-25					FGETWS(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 10:30 PM.