(PHP 4, PHP 5)
fseek — Procura (seeks) em um ponteiro de arquivo
$handle
, int $offset
[, int $whence
] )
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.
handle
A file system pointer resource that is typically created using 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.
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.
Exemplo #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);
?>
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 "http://" ou "ftp://". fseek() dá resultados indefinidos se usados em streams de somente adição (abertos com a flag "a").