fseek
(PHP 4, PHP 5)
fseek — Procura (seeks) em um ponteiro de arquivo
Descrição
Modifica o indicador de posição do arquivo referenciado por handle . A nova posição, medida em bytes a partir do início do arquivo, é obtida ao adicionar offset à posição especificada por whence .
Parâmetros
- handle
-
Um ponteiro para o sistema de arquivos resource é tipicamente criado usando fopen().
- offset
-
A posição.
Para mover até uma posição anterior ao final do arquivo, você precisa passar um valor negativo no offset .
- whence
-
Valores de whence são:
- SEEK_SET - Define a posição igual ao offset bytes.
- SEEK_CUR - Define a posição para a atual localização mais offset .
- SEEK_END - Define a posição para o final do arquivo mais offset .
Se whence não for especificado, é assumido que seja SEEK_SET.
Valor Retornado
Em caso de sucesso, retorna 0; caso contrário, retorna -1. Observe que fazer um seek depois do fim do arquivo (EOF) não é considerado um erro.
Exemplos
Example#1 Exemplo de fseek()
<?php
$fp = fopen('arquivo.txt');
// lê alguns dados
$data = fgets($fp, 4096);
// move de volta para o inicio do arquivo
// o mesmo que rewind($fp);
fseek($fp, 0);
?>
Notas
Nota: Se você abriu o arquivo em modo de adição ("a" ou "a+"), quaisquer dados que você escreva no arquivo serão sempre acrescentados ao final, independente da posição do arquivo.
Nota: Não pode ser usado em ponteiros de arquivo retornados por fopen() se eles usarem os formatos "https://" ou "ftp://". fseek() dá resultados indefinidos se usados em streams de somente adição (abertos com a flag "a").