stream_filter_prepend

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

stream_filter_prepend — Anexa um filtro a um fluxo

Descrição

stream_filter_prepend(
    resource $stream,
    string $filtername,
    int $read_write = ?,
    mixed $params = ?
): resource

Adiciona o nome do filtro filtername à lista de filtros anexados ao fluxo stream.

Parâmetros

stream

O fluxo alvo.

filtername

O nome do filtro.

read_write

Por padrão, stream_filter_prepend() irá anexar o filtro à cadeia de filtros de leitura se o arquivo foi aberto para leitura (isto é, modo de arquivo: r e/ou +). O filtro também será anexado à cadeia de filtros de escrita se o arquivo foi aberto para escrita (isto é, modo de arquivo: w, a e/ou +). As constantes STREAM_FILTER_READ, STREAM_FILTER_WRITE e/ou STREAM_FILTER_ALL também podem ser passadas ao parâmetro read_write para substituir este comportamento. Consulte a função stream_filter_append() para um exemplo de uso deste parâmetro.

params

Este filtro será adicionado com os parâmetros especificados em params ao início da lista e portanto serão chamados em primeiro lugar durante operações de fluxo. Pra adicionar um filtro ao final da lista, use stream_filter_append().

Valor Retornado

Retorna um recurso em caso de sucesso ou false em caso de falha. O recurso pode ser usado para se referir a esta instância de filtro durante uma chamada a stream_filter_remove().

false é retornado se o parâmetro stream não for um recurso ou se o nome do filtro filtername não puder ser localizado.

Notas

Note: Usando filtros personalizados (do usuário)
stream_filter_register() deve ser chamado em primeiro lugar de maneira a registrar o filtro de usuário desejado para o valor de filtername.

Note: Dados de fluxo são lidos dos recursos (tanto locais quanto remotos) em partes, com quaisquer dados não consumidos mantidos em buffers internos. Quando um novo filtro é anexado ao início de um fluxo, os dados nos buffers internos que já foram processados por outros filtros não serão reprocessados pelo novo filtro neste momento. Isto difere do comportamento de stream_filter_append().

Note: Quando um filtro é adicionado para leitura e escrita, duas instâncias do filtro são criadas. stream_filter_prepend() deve ser chamada duas vezes com STREAM_FILTER_READ e STREAM_FILTER_WRITE para obter ambos os recursos de filtro.

Veja Também