Standard C Library Functions                            getwc(3C)



NAME
     getwc - get wide character from a stream

SYNOPSIS
     #include 
     #include 

     wintt 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).

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

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



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     fgetwc(3C), attributes(5), standards(5)





SunOS 5.11          Last change: 24 Jul 2002                    1