fgetws - lee una cadena de caracteres anchos de un flujo FILE
Biblioteca Estándar C (
libc,
-lc)
#include <wchar.h>
wchar_t *fgetws(wchar_t ws[restrict .n], int n, FILE *restrict stream);
The
fgetws() function is the wide-character equivalent of the
fgets(3) function. It reads a string of at most
n-1 wide
characters into the wide-character array pointed to by
ws, and adds a
terminating null wide character (L'\0'). It stops reading wide characters
after it has encountered and stored a newline wide character. It also stops
when end of stream is reached.
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).
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.
Para obtener una explicación de los términos usados en esta
sección, véase
attributes(7).
| Interfaz |
Atributo |
Valor |
|
fgetws() |
Seguridad del hilo |
Multi-hilo seguro |
POSIX.1-2001, POSIX.1-2008, C99.
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(3),
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.
fgetwc(3),
unlocked_stdio(3)
La traducción al español de esta página del manual fue
creada por Juan Piernas <
[email protected]>
Esta traducción es documentación libre; lea la
GNU
General Public License Version 3 o posterior con respecto a las
condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.
Si encuentra algún error en la traducción de esta página
del manual, envíe un correo electrónico a
[email protected]