Funções PHP |
. Glossários Funções PHP - fseek ( ) |
(PHP 3, PHP 4 , PHP 5)
fseek -- Procura (seeks) em um
ponteiro de arquivo
int fseek ( int handle, int offset [, int whence])
Modifica o indicador de posição do arquivo referenciado por handle. A nova posição é obtida, medindo em bytes do início do arquivo, é obtida ao adicionar offset a posição especificada por whence, cujo valor é definido como se segue:
SEEK_SET - Use a posição
igual à offset bytes.
SEEK_CUR - Use a posição para a
localização atual mais offset.
SEEK_END - Use a posição para o
fim do arquivo (eof) mais offset. (Para mover para uma posição
anterior ao fim de arquivo, você precisa passar um valor
negativo em offset.)
Se whence não é especificado é presumido ser SEEK_SET.
Em caso de sucesso, retorna 0; caso contrário, retorna -1. Note que fazer um seek depois do fim do arquivo (eof) é considerado um erro.
Exemplo:
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);
?>
Não pode ser usado em ponteiros de arquivo retornados por fopen() se for usado o formato "http://" ou "ftp://".
Nota: O argumento whence foi adicionado depois do PHP 4.0.0.
Veja também ftell() e rewind().