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