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 multi-octets 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.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/>.
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> ».