Provided by: manpages-fr_1.67.0-1_all bug

NOM

       fgetwc, getwc - Lire une chaîne de caractères larges dans un flux.

SYNOPSIS

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

       wint_t fgetwc (FILE * flux);
       wint_t getwc (FILE * flux);

DESCRIPTION

       La  fonction  fgetwc  est l’équivalent pour les caractères larges de la
       fonction fgetc. Elle lit un  caractère  large  depuis  le  flux  et  le
       renvoie.  Si  la  fin du fichier est rencontrée, elle retourne WEOF. Si
       une erreur se produit lors de la conversion du caractère  large,  errno
       est positionnée à EILSEQ et WEOF est retourné.

       La  fonctiongetwc  fonctionne  de manière identique à fgetwc. Elle peut
       être implémentée sous forme de macro, et  peut  évaluer  ses  arguments
       plus d’une fois. Il n’existe plus aucune raison de l’utiliser.

       Pour  des  versions  de  ces fonctions ignorant les verrouillages, voir
       unlocked_stdio(3).

VALEUR RENVOYÉE

       La fonction fgetwc renvoie le caractère large suivant du flux ou  WEOF.

ERREURS

       Hormis les erreurs habituelles, on peut rencontrer :

       EILSEQ Les  données  lues  depuis  le  flux d’entrée ne forment pas des
              caractères corrects.

CONFORMITÉ

       ISO/ANSI C, UNIX98.

NOTES

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

       En l’absence d’informations supplémentaires passées à l’appel fopen, il
       est normal de présumer que fgetwc va lire une séquence multi-caractères
       du flux puis la convertir en une chaîne à caractères larges.

VOIR AUSSI

       fputwc(3), fgetws(3), ungetwc(3), unlocked_stdio(3)

TRADUCTION

       Thierry Vignaud, 1999
       Christophe Blaess, 2003.