fseek

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

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