fgets, fgetws

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Obtener una cadena de una secuencia.

char *fgets(   
   char *str,  
   int n,  
   FILE *stream   
);  
wchar_t *fgetws(   
   wchar_t *str,  
   int n,  
   FILE *stream   
);  

Parámetros

str
Ubicación de almacenamiento de los datos.

n
Número máximo de caracteres que se va a leer.

stream
Puntero a la estructura FILE .

Cada una de estas funciones devuelve str. NULLse devuelve para indicar un error o una condición de final de archivo. Utilice feof o ferror para determinar si se produjo un error. Si str o stream es un puntero nulo, o n es menor o igual a cero, esta función invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, errno se establece en EINVAL y la función devuelve NULL.

Consulte _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de error.

El fgets función lee una cadena de entrada stream argumento y lo almacena en str. fgetslee los caracteres desde la posición de la secuencia actual e incluyendo el primer carácter de nueva línea al final de la secuencia, o hasta que el número de caracteres leídos es igual a n – 1, lo que ocurra primero. El resultado se almacena en str se anexa con un carácter nulo. Carácter de nueva línea, si lectura, se incluye en la cadena.

fgetws es una versión con caracteres anchos de fgets.

fgetwslee el argumento de caracteres anchos str como una cadena de caracteres multibyte o una cadena de caracteres anchos según si stream se abre en modo de texto o binario, respectivamente. Para obtener más información acerca del uso de modos de texto y binarios en Unicode y multibyte secuencia de e/s, vea texto y E/S de archivo binario de modo y E/S de secuencia de Unicode en los modos de texto y binario.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_fgettsfgetsfgetsfgetws
FunciónEncabezado necesario
fgets<stdio.h>
fgetws<stdio.h> o <wchar.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

// crt_fgets.c  
// This program uses fgets to display  
// a line from a file on the screen.  
//  
  
#include <stdio.h>  
  
int main( void )  
{  
   FILE *stream;  
   char line[100];  
  
   if( fopen_s( &stream, "crt_fgets.txt", "r" ) == 0 )  
   {  
      if( fgets( line, 100, stream ) == NULL)  
         printf( "fgets error\n" );  
      else  
         printf( "%s", line);  
      fclose( stream );  
   }  
}  

Line one.  
Line two.  

Salida

Line one.  

E/S de secuencia
fputs, fputws
gets, _getws
coloca _putws

Mostrar: