Provided by: manpages-fr_1.67.0-1_all bug

NOM

       fgetws - Lire une chaîne de caractères larges depuis un flux.

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.  Elle lit une chaîne d’au plus  n-1  caractères  larges
       dans  le  buffer  de  caractères  larges pointés par ws, puis ajoute un
       caractère 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 wst.

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

VALEUR RENVOYÉE

       La fonction fgetws, lorsqu’elle réussit, renvoie ws. Si la fin du  flux
       est atteinte, ou si une erreur se produit, elle renvoie NULL.

CONFORMITÉ

       ISO/ANSI C, UNIX98

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(),
       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)

TRADUCTION

       Christophe Blaess, 2000-2003.