Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

rewind — voltar ao início de um ficheiro

rewind posiciona um fluxo no início do respetivo ficheiro e limpa o indicador de erro. Não devolve qualquer valor, pelo que não permite saber diretamente se o reposicionamento foi bem-sucedido.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

rewind(stream), de <stdio.h>, posiciona um fluxo FILE aberto no início do respetivo ficheiro. Passe um ponteiro válido para um fluxo aberto, não NULL nem um ponteiro usado depois de fclose.

A função atua como (void)fseek(stream, 0L, SEEK_SET), mas também limpa o indicador de erro. Se o reposicionamento for bem-sucedido, limpa ainda o indicador de fim de ficheiro e anula os efeitos de ungetc. Não apaga o conteúdo do ficheiro.

Devolve void. Quando for necessário detetar falhas de posicionamento, use fseek e verifique o resultado. Verificar apenas ferror depois de rewind não confirma o sucesso. Não parta do princípio de que todos os fluxos suportam posicionamento.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes