4.5.5.1 Filter Methods

pass_on()

Passes all data throught the filter without any processing.

read([length])

Reads at most len bytes from the next filter, returning a string with the data read or None if End Of Stream (EOS) has been reached. A filter must be closed once the EOS has been encountered.

If the len argument is negative or ommitted, reads all data currently available.

readline([length])

Reads a line from the next filter or up to length bytes.

write(string)

Writes string to the next filter.

flush()

Flushes the output by sending a FLUSH bucket.

close()

Closes the filter and sends an EOS bucket. Any further IO operations on this filter will throw an exception.

disable()

Tells mod_python to ignore the provided handler and just pass the data on. Used internally by mod_python to print traceback from exceptions encountered in filter handlers to avoid an infinite loop.