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.57 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> ».