GETWC(3C) Standard C Library Functions GETWC(3C)

NAME

getwc, getwc_l - get wide character from a stream

SYNOPSIS

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

wint_t getwc(FILE *stream);

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

wint_t getwc_l(FILE *stream, locale_t loc);

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 expression with side effects.

The getwc_l() function is similar to getwc(), except instead of acting on
the current locale, it uses the locale specified by loc.

RETURN VALUES

Refer to fgetwc(3C).

ERRORS

Refer to fgetwc(3C).

USAGE

This interface is provided to align with some current implementations and
with possible future ISO standards.

Because they may be implemented as macros, these functions may treat
incorrectly a stream argument with side effects. In particular,
getwc(*f++) may not work as expected. Therefore, use of these functions
is not recommended; fgetwc(3C) and fgetwc_l(3C) should be used instead.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | See below. |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

The getwc() function is Standard. The getwc_l() function is Uncommitted.

SEE ALSO

fgetwc(3C), newlocale(3C), setlocale(3C), uselocale(3C), attributes(7),
standards(7)


July 11, 2014 GETWC(3C)