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