(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::stream_seek — Pesquisa uma localização específica em um fluxo
Este método é chamado em resposta a fseek().
A posição de leitura/escrita do fluxo deve ser atualizada de acordo com os parâmetros
offset e whence.
offsetO deslocamento no fluxo a pesquisar.
whenceValores posssíveis:
SEEK_SET - Definir a posição igual ao número de bytes em offset.SEEK_CUR - Definir a poisção igual à localização atual mais offset.SEEK_END - Definir a poisção do fim do arquivo mais offset.Nota: A implementação atual nunca define o parâmetro
whenceparaSEEK_CUR; em vez disso, tais pesquisas são internamente convertidas para pesquisasSEEK_SET.
Nota:
Se não implementado,
falseé assumido como o valor de retorno.
Nota:
Em caso de sucesso, streamWrapper::stream_tell() é chamado diretamente após a chamada a streamWrapper::stream_seek(). Se streamWrapper::stream_tell() falhar, o valor de retorno à função chamadora será definida para
false.
Nota:
Nem todas as operações de pesquisa no fluxo irão resultar na chamada a esta função. Fluxos PHP tem buffer de leitura habilitado por padrão (veja também stream_set_read_buffer()) e a pesquisa pode ser feita simplesmente movendo-se o ponteiro do buffer.