Provided by: manpages-es_1.55-3_all bug

NOMBRE

       fgetws - lee una cadena de caracteres anchos de un flujo FILE

SINOPSIS

       #include <wchar.h>

       wchar_t *fgetws (wchar_t *ws, int n, FILE *stream);

DESCRIPCIÓN

       La  función  fgetws  es equivalente para caracteres anchos a la función
       fgets. Lee una cadena de, como  mucho,  n-1  caracteres  anchos  y  los
       almacena en el array de caracteres anchos apuntado por ws, añadiendo un
       carácter terminador L’\0’. La función deja de  leer  caracteres  anchos
       después  de que haya encontrado y almacenado un carácter ancho de nueva
       línea. También se detiene cuando llega al final del flujo.

       El programador debe garantizar que hay espacio suficiente en  ws  para,
       al menos, n caracteres anchos.

       Para la versión no-bloqueante, véase unlocked_stdio(3).

VALOR DEVUELTO

       La  función  fgetws devuelve ws en caso de éxito. Si ya se ha alcanzado
       el final del flujo o se ha producido un error, devuelve NULL.

CONFORME A

       ISO/ANSI C, UNIX98

OBSERVACIONES

       El comportamiento de fgetws depende de  la  categoría  LC_CTYPE  de  la
       localización actual.

       En  ausencia  de  información  adicional  pasada a la llamada fopen, es
       razonable esperar que fgetws lea realmente  una  cadena  multibyte  del
       flujo y que la convierta después en una cadena de caracteres anchos.

       Esta  función  no  es fiable ya que no permite tratar adecuadamente los
       caracteres anchos nulos que se puedan presentar en la entrada.

VÉASE TAMBIÉN

       fgetwc(3), unlocked_stdio(3)