(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
.
offset
O deslocamento no fluxo a pesquisar.
whence
Valores 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
whence
paraSEEK_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.