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.

C99.

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.

fgetwc(3), unlocked_stdio(3)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 29 août 2000 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 getwchar ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.