Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

rewind — volver al principio de un archivo

rewind coloca un flujo al principio de su archivo y borra su indicador de error. No devuelve ningún valor, por lo que no permite saber directamente si el reposicionamiento se ha realizado correctamente.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <stdio.h>
void rewind(FILE *stream);

rewind(stream), de <stdio.h>, coloca un flujo FILE abierto al principio de su archivo. Pasa un puntero válido a un flujo abierto, no NULL ni un puntero usado después de fclose.

Actúa como (void)fseek(stream, 0L, SEEK_SET), pero también borra el indicador de error. Si el reposicionamiento se realiza correctamente, también borra el indicador de fin de archivo y deshace los efectos de ungetc. No borra el contenido del archivo.

Devuelve void. Si necesitas detectar errores de posicionamiento, usa fseek y comprueba su resultado. Comprobar solo ferror después de rewind no confirma que la operación haya tenido éxito. No des por sentado que todos los flujos permiten el posicionamiento.

Ejemplos

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    FILE *stream = tmpfile();
    if (stream == NULL) {
        return EXIT_FAILURE;
    }
    if (fputs("ABC", stream) == EOF || fflush(stream) == EOF) {
        fclose(stream);
        return EXIT_FAILURE;
    }

    rewind(stream);
    int first = fgetc(stream);
    if (first != 'A') {
        fclose(stream);
        return EXIT_FAILURE;
    }

    if (fclose(stream) == EOF) {
        return EXIT_FAILURE;
    }
    if (printf("first: %c\n", first) < 0) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Resultado

first: A

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes