Pular para o conteúdo principal

fseek

aviso

Esta função começa com uma letra minúscula.

Descrição​

Altere a posição atual no arquivo. Você pode avançar ou retroceder no arquivo.

NomeDescrição
File:handleO identificador de arquivo a ser usado. Retornado por fopen.
positionA nova posição no arquivo, relativa ao parâmetro de origem (veja abaixo).
seek_whence:whenceA posição inicial à qual a posição do parâmetro se refere.

Retornos​

A nova posição; em relação ao início do arquivo.

Exemplos​

// Abra "file.txt" no modo "somente leitura"
new File:handle = fopen("file.txt", io_read);

// Se "file.txt" estiver aberto
if (handle)
{
    // Sucesso

    // Vá para o 1º byte de "file.txt" e imprima sua posição
    printf("Begin of file position: %d", fseek(handle, 0, seek_start));

    // Vá para o último byte de "file.txt" e imprima sua posição
    printf("End of file position: %d", fseek(handle, 0, seek_end));

    // Vá para o mesmo byte de "file.txt" e imprima sua posição
    printf("Currrent file position: %d", fseek(handle, 0, seek_current));

    // Feche "file.txt"
    fclose(handle);
}
else
{
    // Erro
    print("Failed to open \"file.txt\".");
}

Notas​

aviso

Usar um identificador inválido irá travar seu servidor! Obtenha um identificador válido usando fopen ou ftemp.

Funções Relacionadas​

  • fopen: Abra um arquivo.
  • fclose: Fecha um arquivo.
  • ftemp: Crie um fluxo de arquivo temporário.
  • fremove: Remove um arquivo.
  • fwrite: Grava em um arquivo.
  • fread: Leia um arquivo.
  • fputchar: Coloca um caractere em um arquivo.
  • fgetchar: Obtenha um caractere de um arquivo.
  • fblockwrite: Grava blocos de dados em um arquivo.
  • fblockread: Lê blocos de dados de um arquivo.
  • flength: Obtenha o comprimento do arquivo.
  • fexist: Verifica se existe um arquivo.
  • fmatch: Verifica se os padrões com um nome de arquivo correspondem.
  • ftell: Obtenha a posição atual no arquivo.
  • fflush: Descarregue um arquivo no disco (certifique-se de que todas as gravações foram concluídas).
  • fstat: Retorna o tamanho e o carimbo de data/hora de um arquivo.
  • frename: Renomeia um arquivo.
  • fcopy: Copia um arquivo.
  • filecrc: Retorna o valor CRC de 32 bits de um arquivo.
  • diskfree: Retorna o espaço livre em disco.
  • fattrib: Defina os atributos do arquivo.
  • fcreatedir: Crie um diretório.

Recursos relacionados​