fseek

(PHP 3, PHP 4 )

fseek -- Procura (seeks) em um ponteiro de arquivo

Descrição

int fseek ( int fp, int offset [, int whence])

Modifica o indicador de posição do arquivo referenciado por fp. 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.

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.

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 RC1.

Veja também ftell() e rewind().