NOM

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

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

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  renvoie  WEOF. Si une erreur de
       conversion de caractère large se produit, errno est défini à EILSEQ et WEOF est renvoyé.

       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. Sinon, WEOF  est  renvoyé
       et errno est positionné pour indiquer 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.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │Interface                                               │ Attribut             │ Valeur  │
       ├────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │fgetwc(), getwc()                                       │ Sécurité des threads │ MT-Safe │
       └────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       C11, POSIX.1-2008.

HISTORIQUE

       POSIX.1-2001, C99.

NOTES

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

       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)

TRADUCTION

       La  traduction  française  de  cette  page  de  manuel  a  été créée par Christophe Blaess
       <https://www.blaess.fr/christophe/>, Stéphan  Rafin  <stephan.rafin@laposte.net>,  Thierry
       Vignaud  <tvignaud@mandriva.com>,  François Micaux, Alain Portal <aportal@univ-montp2.fr>,
       Jean-Philippe   Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)    <jean-
       luc.coulon@wanadoo.fr>,    Julien    Cristau    <jcristau@debian.org>,    Thomas   Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau  <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
       Barbier  <barbier@debian.org>,  David  Prévot  <david@tilapin.org>  et  Frédéric  Hantrais
       <fhantrais@gmail.com>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General
       Public  License  version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   concernant   les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.