Manual Pages for UNIX Operating System command usage for man getwc

Standard C Library Functions                            getwc(3C)



NAME
     getwc - get wide character from a stream

SYNOPSIS
     #include 
     #include 

     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             |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


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





SunOS 5.11          Last change: 24 Jul 2002                    1