Provided by:
manpages-es_1.55-3_all 
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)