FGETWS

Section: Manual del Programador de Linux (3)
Updated: 25 julio 1999
Index Return to Main Contents


 

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.  

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  

VÉASE TAMBIÉN

fgetwc

(3)  

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.


 

Index

NOMBRE
SINOPSIS
DESCRIPCIÓN
VALOR DEVUELTO
CONFORME A
VÉASE TAMBIÉN
OBSERVACIONES

This document was created by man2html, using the manual pages.
Time: 06:16:23 GMT, January 22, 2005