Home > PHP > Function > Streams > stream_filter_append()

stream_filter_append()

stream_filter_append - Attach a filter to a stream

Syntax

resource stream_filter_append (resource $stream, string $filtername, int $read_write, mixed $params)

Arguments

  • stream - The target stream.
  • filtername - The filter name.
  • read_write - By default, stream_filter_append() will attach the filter to the read filter chainif the file was opened for reading (i.e. File Mode: r, and/or +). The filter will also be attached to the write filter chainif the file was opened for writing (i.e. File Mode: w, a, and/or +). STREAM_FILTER_READ, STREAM_FILTER_WRITE, and/or STREAM_FILTER_ALL can also be passed to the read_write parameter to override this behavior.
  • params - This filter will be added with the specified params to the endof the list and will therefore be called last during stream operations. To add a filter to the beginning of the list, use stream_filter_prepend().

Description

Adds filtername to the list of filters attached to stream.

Version

PHP 4.3.0, 5

Return value

Returns a resource which can be used to refer to this filter instance during a call to stream_filter_remove().