fgetws(3)                  Library Functions Manual                  fgetws(3)

NOM
       fgetws - Lire une chaine de caracteres larges depuis un flux FILE

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <wchar.h>

       wchar_t *fgetws(wchar_t ws[restrict .n], int n, FILE *restrict stream);

DESCRIPTION
       La fonction fgetws() est l'equivalent pour les caracteres larges de la
       fonction fgets(3). Elle lit une chaine de caracteres d'au plus n-1
       caracteres larges dans le tableau de caracteres larges pointe par ws,
       puis ajoute un caractere large NULL final (L'\0'). La lecture s'arrete
       des qu'un caractere large de saut de ligne a ete rencontre et stocke.
       Elle s'arrete aussi lorsque la fin du flux est atteinte.

       Il est de la responsabilite du programmeur de s'assurer qu'il y a assez
       de place pour au moins n caracteres larges dans ws.

       Pour une version de cette fonction ignorant les verrouillages, voir
       unlocked_stdio(3).

VALEUR RENVOYEE
       La fonction fgetws() renvoie ws s'il n'y a pas d'erreur. Si la fin du
       flux est deja atteinte, ou si une erreur se produit, elle renvoie NULL.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |fgetws()                         | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
STANDARDS
       C11, POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, C99.

NOTES
       Le comportement de fgetws() depend de la categorie LC_CTYPE de la
       localisation.

       En l'absence d'information supplementaire transmise a l'appel fopen(3),
       on peut raisonnablement supposer que fgetws() lira en fait une chaine
       multioctet depuis le flux, et la convertira en chaine de caracteres
       larges.

       Cette fonction n'est pas fiable, car elle ne permet pas de traiter
       correctement les caracteres larges NULL, susceptible d'etre rencontres
       en entree.

VOIR AUSSI
       fgetwc(3), unlocked_stdio(3)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Jean-Baptiste Holcroft <jean-baptiste@holcroft.fr>
       et Gregoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                      fgetws(3)