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

CKTIS / C

SEEK_SET, SEEK_CUR, SEEK_END — origens do posicionamento

As macros SEEK_SET, SEEK_CUR e SEEK_END selecionam o ponto de referência de fseek: o início, a posição atual ou o fim do ficheiro.

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

Sintaxe

#include <stdio.h>
int fseek(FILE *stream, long int offset, int whence);
/* whence: SEEK_SET, SEEK_CUR, SEEK_END */

Estas macros de <stdio.h> têm valores inteiros distintos; não pressuponhas valores numéricos específicos. O argumento whence seleciona a base: SEEK_SET — início do ficheiro, SEEK_CUR — posição atual, SEEK_END — fim do ficheiro.

Num fluxo binário, fseek adiciona offset a essa base, medido em bytes C. O suporte de SEEK_END não é garantido, mesmo em fluxos binários. Num fluxo de texto, offset tem de ser zero ou provir de uma chamada anterior bem-sucedida a ftell para o mesmo ficheiro; neste último caso, é necessário usar SEEK_SET.

Verifica o resultado de fseek: zero significa sucesso; um valor diferente de zero significa falha.

Exemplos

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

int main(void)
{
    FILE *f = tmpfile();
    int a, b;
    if (f == NULL) return EXIT_FAILURE;

    if (fputs("ABCDE", f) == EOF ||
        fseek(f, 1L, SEEK_SET) != 0) {
        fclose(f);
        return EXIT_FAILURE;
    }
    a = fgetc(f);
    if (a == EOF || fseek(f, 1L, SEEK_CUR) != 0) {
        fclose(f);
        return EXIT_FAILURE;
    }
    b = fgetc(f);
    if (b == EOF || fclose(f) != 0) return EXIT_FAILURE;

    if (printf("%c %c\n", a, b) < 0) return EXIT_FAILURE;
    return EXIT_SUCCESS;
}

Resultado

B D

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