rewind

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

void rewind(
   FILE *stream 
);

Parámetros

  • stream
    puntero a la estructura de ARCHIVO .

Comentarios

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

fseek (vacío) ( stream**,0L,** SEEK_SET);

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

Para borrar el búfer de teclado, utilice rebobinado con la secuencia stdin, que está asociado con 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 éstos 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 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 );
   }
}

Output

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, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.

Vea también

Referencia

E/S de la secuencia