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.