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)