rewind

 

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

Coloca el puntero de archivo en el principio de un archivo.

  
      void rewind(  
   FILE *stream   
);  

Parámetros

stream
Puntero a la estructura FILE.

La función de rewind coloca el puntero de archivo de nuevo asociado a stream al principio del archivo. Una llamada a rewind es similar a

(void) fseek( stream,0L, SEEK_SET);

Sin embargo, a diferencia de fseek, rewind borra los indicadores de error para la secuencia junto con la marca de fin de archivo. Además, a diferencia de fseek, rewind no devuelve un valor para indicar si el puntero se ha movido correctamente.

Para borrar el búfer de teclado, utilice rewind con la secuencia stdin, que se asocia el teclado de forma predeterminada.

Si la secuencia es un puntero de NULL , se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros. Si la ejecución puede continuar, esta función devuelve y errno se establece en EINVAL.

Para obtener información sobre estos y otros códigos de error, vea _doserrno, errno, _sys_errlist y _sys_nerr.

RutinaEncabezado necesario
rebobinado<stdio.h>

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

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

// crt_rewind.c  
/* This program first opens a file named  
 * crt_rewind.out for input and output and writes two  
 * integers to the file. Next, it uses rewind to  
 * reposition the file pointer to the beginning of  
 * the file and reads the data back in.  
 */  
#include <stdio.h>  
  
int main( void )  
{  
   FILE *stream;  
   int data1, data2;  
  
   data1 = 1;  
   data2 = -37;  
  
   fopen_s( &stream, "crt_rewind.out", "w+" );  
   if( stream != NULL )  
   {  
      fprintf( stream, "%d %d", data1, data2 );  
      printf( "The values written are: %d and %d\n", data1, data2 );  
      rewind( stream );  
      fscanf_s( stream, "%d %d", &data1, &data2 );  
      printf( "The values read are: %d and %d\n", data1, data2 );  
      fclose( stream );  
   }  
}  

The values written are: 1 and -37  
The values read are: 1 and -37  

No es aplicable Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

E/S de secuencia

Mostrar: