NOM¶
fgetws - Lire une chaîne de caractères larges depuis un flux FILE
SYNOPSIS¶
#include <wchar.h>
wchar_t *fgetws(wchar_t *ws, int n, FILE *stream);
DESCRIPTION¶
La fonction
fgetws() est l'équivalent pour les caractères
larges de la fonction
fgets(3). Elle lit une chaîne de
caractères d'au plus
n-1 caractères larges dans le
tableau de caractères larges pointés par
ws, puis ajoute
un caractère large nul (L'\0') final. La lecture s'arrête
dès qu'un caractère large de saut de ligne a été
rencontré, et stocké. Elle s'arrête aussi lorsque la fin
du flux est atteinte.
Il est de la responsabilité du programmeur de s'assurer qu'il y a assez
de place pour au moins
n caractères larges dans
ws.
Pour une version de cette fonction ignorant les verrouillages, voir
unlocked_stdio(3).
VALEUR RENVOYÉE¶
La fonction
fgetws() renvoie
ws s'il n'y a pas d'erreur. Si la fin
du flux est déjà atteinte, ou si une erreur se produit, elle
renvoie NULL.
C99, POSIX.1-2001.
NOTES¶
Le comportement de
fgetws() dépend de la catégorie
LC_CTYPE de la localisation.
En l'absence d'information supplémentaire transmise à l'appel
fopen(3), on peut raisonnablement supposer que
fgetws() lira en
fait une chaîne multioctet depuis le flux, et la convertira en
chaîne de caractères larges.
Cette fonction n'est pas fiable, car elle ne permet pas de traiter correctement
les caractères larges nuls, susceptible d'être rencontrés
en entrée.
VOIR AUSSI¶
fgetwc(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/>.
Christophe Blaess <
http://www.blaess.fr/christophe/> (1996-2003), Alain
Portal <
http://manpagesfr.free.fr/> (2003-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> ».
