.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification
.\"     http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetws 3 "23 juillet 2024" "Pages du manuel de Linux 6.12" 
.SH NOM
fgetws \- Lire une chaîne de caractères larges depuis un flux FILE
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP,\ \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#include <wchar.h>\fP
.P
\fBwchar_t *fgetws(wchar_t \fP\fIws\fP\fB[restrict .\fP\fIn\fP\fB], int \fP\fIn\fP\fB, FILE *restrict \fP\fIstream\fP\fB);\fP
.fi
.SH DESCRIPTION
The \fBfgetws\fP()  function is the wide\-character equivalent of the
\fBfgets\fP(3)  function.  It reads a string of at most \fIn\-1\fP wide characters
into the wide\-character array pointed to by \fIws\fP, and adds a terminating
null wide character (L\[aq]\[rs]0\[aq]).  It stops reading wide characters
after it has encountered and stored a newline wide character.  It also stops
when end of stream is reached.
.P
Il est de la responsabilité du programmeur de s'assurer qu'il y a assez de
place pour au moins \fIn\fP caractères larges dans \fIws\fP.
.P
Pour une version de cette fonction ignorant les verrouillages, voir
\fBunlocked_stdio\fP(3).
.SH "VALEUR RENVOYÉE"
La fonction \fBfgetws\fP() renvoie \fIws\fP 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.
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
.na
.nh
\fBfgetws\fP()
T}	Sécurité des threads	MT\-Safe
.TE
.SH STANDARDS
C11, POSIX.1\-2008.
.SH HISTORIQUE
POSIX.1\-2001, C99.
.SH NOTES
Le comportement de \fBfgetws\fP() dépend de la catégorie \fBLC_CTYPE\fP de la
localisation.
.P
En l'absence d'information supplémentaire transmise à l'appel \fBfopen\fP(3),
on peut raisonnablement supposer que \fBfgetws\fP() lira en fait une chaîne
multioctet depuis le flux, et la convertira en chaîne de caractères larges.
.P
Cette fonction n'est pas fiable, car elle ne permet pas de traiter
correctement les caractères larges NULL, susceptible d'être rencontrés en
entrée.
.SH "VOIR AUSSI"
\fBfgetwc\fP(3), \fBunlocked_stdio\fP(3)
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess <https://www.blaess.fr/christophe/>,
Stéphan Rafin <stephan.rafin@laposte.net>,
Thierry Vignaud <tvignaud@mandriva.com>,
François Micaux,
Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>,
Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>,
Julien Cristau <jcristau@debian.org>,
Thomas Huriaux <thomas.huriaux@gmail.com>,
Nicolas François <nicolas.francois@centraliens.net>,
Florentin Duneau <fduneau@gmail.com>,
Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
Denis Barbier <barbier@debian.org>,
David Prévot <david@tilapin.org>,
Jean-Baptiste Holcroft <jean-baptiste@holcroft.fr>
et
Grégoire Scano <gregoire.scano@malloc.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .