getwchar − Lecture d’un caractère large depuis l’entrée standard.

#include <wchar.h>

wint_t getwchar (void);

La fonction getwchar est l’équivalent pour les caractères larges de la fonction getchar. Elle lit un caractère large depuis stdin et le renvoie. Si la fin du flux est atteinte, ou si ferror(stdin) devient vrai, elle renvoie WEOF. Si une erreur de conversion de caractère large se produit, elle place EILSEQ dans errno et renvoie WEOF.

Pour un équivalent ignorant les verrouillages, voir unlocked_stdio(3).

La fonction getwchar renvoie le caractère large suivant lu dans l’entrée standard, ou WEOF.

ISO/ANSI C, UNIX98

fgetwc(3), unlocked_stdio(3)

Le comportement de getwchar dépend de la catégorie LC_CTYPE de la localisation.

On peut supposer raisonnablement que getwchar lira en fait une séquence multi-octets depuis l’entrée standard, et la convertira en caractère large.

Christophe Blaess, 2000.