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
       The fgetws()  function is the wide-character equivalent of the fgets(3)
       function.  It reads a string of at most n-1 wide characters into the
       wide-character array pointed to by ws, and adds a terminating null wide
       character (L'\0').  It stops reading wide characters after it has
       encountered and stored a newline wide character.  It also stops when
       end of stream is reached.

       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.9.1   15 juin 2024                        fgetws(3)