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)