ungetwc(3)                                                   ungetwc(3)

  ungetwc()

  NAME

    ungetwc() - un-get wide-character code from input stream

  SYNOPSIS

    #include 
    #include 

    wint_t ungetwc (wint_t wc, FILE *stream)

  DESCRIPTION

    The ungetwc(3) function pushes the wide-character code wc back onto the
    input stream pointed to by stream. The pushed-backed characters will be
    returned by subsequent reads on the stream (in reverse order). A
    successful intervening call, using the same stream, to one of the file
    positioning functions (fseek(3), fsetpos(3), or rewind(3)) will discard
    the pushed back characters.

    One character of push-back is guaranteed, but as long as there is
    sufficient memory, an effectively infinite amount of pushback is allowed.

    If a character is successfully pushed-back, the end-of-file indicator for
    the stream is cleared.

    If the value of the argument wc character equals WEOF, the operation will
    fail and the stream will remain unchanged.

  RETURN VALUES

    The ungetwc(3) function returns the character pushed-back after the
    conversion, or WEOF if the operation fails.

  SEE ALSO

    getwc(3)

    fseek(3)

    setvbuf(3)

  USAGE NOTES

    The ungetwc function is thread safe.

    The ungetwc function is not async-signal safe.