Manual do PHP
Anterior |  | Próxima

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

Anterior | Principal | Próxima
fscanf | Acima | fstat