NOM

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

SYNOPSIS

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

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

DESCRIPTION

       La  fonction  fgetwc()  est  l'équivalent pour les caractères larges de la fonction fgetc(3). Elle lit un
       caractère large depuis stream et le renvoie. Si la fin du fichier est rencontrée,  ou  si  ferror(stream)
       devient  vrai,  elle  retourne WEOF. Si une erreur de conversion de caractère large se produit, errno est
       défini à EILSEQ et WEOF est retourné.

       La fonction ou la macro getwc() 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'y a aucune raison de ne pas
       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. En cas  d'erreur,  errno  permet
       d'identifier la cause de l'erreur.

ERREURS

       En plus des erreurs habituelles, il y a :

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

CONFORMITÉ

       C99, POSIX.1-2001.

NOTES

       Le comportement de fgetwc() dépend de la catégorie LC_CTYPE de la localisation actuelle.

       En  l'absence  d'informations  supplémentaires  passées à l'appel fopen(3), il est normal de présumer que
       fgetwc() va lire en réalité une séquence multioctet depuis le flux puis la convertir  en  une  chaîne  de
       caractères larges.

VOIR AUSSI

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

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des
       instructions     pour     signaler     des     anomalies    peuvent    être    trouvées    à    l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Thierry Vignaud (2002), Alain Portal <http://manpagesfr.free.fr/> (2006). Florentin  Duneau  et  l'équipe
       francophone de traduction de Debian (2006-2009).

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».

GNU                                               19 avril 2013                                        FGETWC(3)