rewindrewind

Cambia la posición del puntero de archivo al principio de un archivo.Repositions the file pointer to the beginning of a file.

SintaxisSyntax

void rewind(
   FILE *stream
);

ParámetrosParameters

misionesstream
Puntero a la estructura FILE.Pointer to FILE structure.

ObservacionesRemarks

La función Rewind cambia la posición del puntero de archivo asociado al flujo al principio del archivo.The rewind function repositions the file pointer associated with stream to the beginning of the file. Una llamada a rewind es similar aA call to rewind is similar to

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

Sin embargo, a diferencia de fseek, el rebobinado borra los indicadores de error de la secuencia, así como el indicador de fin de archivo.However, unlike fseek, rewind clears the error indicators for the stream as well as the end-of-file indicator. Además, a diferencia de fseek, el rebobinado no devuelve un valor para indicar si el puntero se ha colocado correctamente.Also, unlike fseek, rewind does not return a value to indicate whether the pointer was successfully moved.

Para borrar el búfer del teclado, use el rebobinado con la secuencia stdin, que está asociada con el teclado de forma predeterminada.To clear the keyboard buffer, use rewind with the stream stdin, which is associated with the keyboard by default.

Si Stream es un puntero nulo , se invoca el controlador de parámetros no válidos, tal y como se describe en validación de parámetros.If stream is a NULL pointer, the invalid parameter handler is invoked, as described in Parameter Validation. Si la ejecución puede continuar, esta función devuelve y errno se establece en EINVAL.If execution is allowed to continue, this function returns and errno is set to EINVAL.

Para obtener información sobre estos y otros códigos de error, vea _doserrno, errno, _sys_errlist y _sys_nerr.For information on these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

De forma predeterminada, el ámbito de este estado global de esta función es la aplicación.By default, this function's global state is scoped to the application. Para cambiar esto, vea estado global en CRT.To change this, see Global state in the CRT.

RequisitosRequirements

RutinaRoutine Encabezado necesarioRequired header
rebobinarrewind <stdio.h>

Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

BibliotecasLibraries

Todas las versiones de las bibliotecas en tiempo de ejecución de C.All versions of the C run-time libraries.

EjemploExample

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

SalidaOutput

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

Vea tambiénSee also

E/S de secuenciaStream I/O