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.
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.
C99, POSIX.1-2001.
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(3), il est normal de présumer que
fgetwc() va lire en
réalité une séquence multi-octets 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.44 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> ».