fgetwc, getwc - Lire une chaîne de caractères larges dans un flux
FILE
Bibliothèque C standard (
libc,
-lc)
#include <stdio.h>
#include <wchar.h>
wint_t fgetwc(FILE *stream);
wint_t getwc(FILE *stream);
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).
La fonction
fgetwc() renvoie le caractère large suivant du flux.
Sinon,
WEOF est renvoyé et
errno est positionné
pour indiquer l'erreur.
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.
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
| Interface |
Attribut |
Valeur |
|
fgetwc(), getwc() |
Sécurité des threads |
MT-Safe |
POSIX.1-2001, POSIX.1-2008, C99.
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.
fgetws(3),
fputwc(3),
ungetwc(3),
unlocked_stdio(3)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Frédéric Hantrais <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 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 à
[email protected]