(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.
handleA file system pointer resource that is typically created using fopen().
offsetA 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").