fseek
(PHP 4, PHP 5)
fseek — Procura (seeks) em um ponteiro de arquivo
Descrição
$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.
Parâmetros
-
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
whencesão:SEEK_SET- Define a posição igual aooffsetbytes.SEEK_CUR- Define a posição para a atual localização maisoffset.SEEK_END- Define a posição para o final do arquivo maisoffset.
Se
whencenão for especificado, é assumido que sejaSEEK_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
Note:
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.
Note:
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").