getwc(3C)




NAME

     getwc - get wide character from a stream


SYNOPSIS

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

     wint_t getwc(FILE *stream);


DESCRIPTION

     The getwc() function is  equivalent  to  fgetwc(3C),  except
     that  if it is implemented as a macro it may evaluate stream
     more than once, so the argument should never be  an  expres-
     sion with side effects.


RETURN VALUES

     Refer to fgetwc(3C).


ERRORS

     Refer to fgetwc(3C).


USAGE

     This interface is provided to align with some current imple-
     mentations and with possible future ISO standards.

     Because it may be implemented as a macro, getwc() may  treat
     incorrectly a stream argument with side effects.  In partic-
     ular, getwc(*f++) may not work as expected.  Therefore,  use
     of  this  function  is not recommended; fgetwc(3C) should be
     used instead.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO

     fgetwc(3C), attributes(5)


Man(1) output converted with man2html