fseek

(PHP 3, PHP 4 , PHP 5)

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

Descrição

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 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().