PEAR Manual
Prev |  | Next

# HTML_QuickForm::applyFilter()

HTML_QuickForm::applyFilter() -- Applies a filter for the given field(s)

## Synopsis

    require_once 'HTML/QuickForm.php';

``void HTML_QuickForm::applyFilter` (mixed $element, mixed $filter)`

## Description

Applies a data filter for the given field(s). Filter is applied recursively.

## Parameter

mixed `$element`

  Form element name or array of such names. Special name `'__ALL__'` means all the form elements.

mixed `$filter`

  Callback, either function name or array(&$object, 'method')

## Throws

Table 41-1. Possible PEAR_Error values

Error code | Error message | Reason | Solution
--- | --- | --- | ---
`QUICKFORM_NONEXIST_ELEMENT` | Element '`$elName`' does not exist in HTML_QuickForm::applyFilter() | Tried to apply a filter to a non-existant element | Check the element's name spelling
`QUICKFORM_INVALID_FILTER` | Callback function does not exist in QuickForm::applyFilter() | Tried to pass a name of a non-existant function as a callback | Check spelling

## Note

since 2.0

This function can not be called statically.

Prev | Home | Next
HTML_QuickForm::isRuleRegistered() | Up | HTML_QuickForm_Controller