Compartir a través de


rewind

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

void rewind( 
   FILE *stream  
);

Parámetros

  • stream
    Puntero a la estructura FILE.

Comentarios

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.

Requisitos

Rutina

Encabezado necesario

rebobinado

<stdio.h>

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

Bibliotecas

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

Ejemplo

// 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 );
   }
}

Resultados

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

Equivalente en .NET Framework

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.

Vea también

Referencia

E/S de secuencia