Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

rewind — tornare all’inizio di un file

rewind posiziona un flusso all’inizio del relativo file e azzera l’indicatore di errore. Non restituisce alcun valore, quindi non consente di sapere direttamente se il riposizionamento è riuscito.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

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

rewind(stream) di <stdio.h> posiziona un flusso FILE aperto all’inizio del relativo file. Passa un puntatore valido a un flusso aperto, non NULL né un puntatore usato dopo fclose.

Agisce come (void)fseek(stream, 0L, SEEK_SET), ma azzera anche l’indicatore di errore. Se il riposizionamento riesce, azzera inoltre l’indicatore di fine file e annulla gli effetti di ungetc. Non cancella il contenuto del file.

Restituisce void. Se è necessario rilevare gli errori di posizionamento, usa fseek e controllane il risultato. Controllare solo ferror dopo rewind non conferma che l’operazione sia riuscita. Non dare per scontato che tutti i flussi supportino il posizionamento.

Esempi

#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;
}

Risultato

first: A

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti