filter_var

filter_var(mixed $value, [int $filter], [array $options]): mixed
```php

Filtra una variable usando un filtro de validación `FILTER_VALIDATE_*`, un filtro de saneamiento `FILTER_SANITIZE_*`, o un filtro definido por el usuario.

## Parámetros

`value`  
Valor a filtrar.

> [!WARNING]
> Valores escalares son [convertidos a string](#language.types.string.casting) internamente antes de ser filtrados.

`filter`  
El filtro a aplicar. Puede ser un filtro de validación usando una de las constantes `FILTER_VALIDATE_*`, un filtro de saneamiento usando una de las constantes `FILTER_SANITIZE_*` o `FILTER_UNSAFE_RAW`, o un filtro personalizado usando `FILTER_CALLBACK`.

> [!NOTE]
> Por omisión es `FILTER_DEFAULT`, que es un alias de `FILTER_UNSAFE_RAW`. Esto resultará en que no se aplique ningún filtro por omisión.

`options`  
O bien un `array` asociativo de opciones, o bien una máscara de bits de constantes de indicadores de filtro `FILTER_FLAG_*`.

Si el `filter` acepta opciones, los indicadores pueden ser proporcionados usando el campo `"flags"` del array.

## Valores devueltos

En caso de éxito devuelve la variable filtrada. En caso de fallo se devuelve `false`, a menos que se use el flag `FILTER_NULL_ON_FAILURE`, en cuyo caso se devuelve `null`.

## Ejemplos

Ejemplo de `filter_var`

El ejemplo anterior mostrará:

    string(15) "bob@example.com"
    bool(false)

Ejemplo validando entradas de un array

El ejemplo anterior mostrará:

    array(3) {
      [0]=>
      string(15) "bob@example.com"
      [1]=>
      string(18) "test@example.local"
      [2]=>
      bool(false)
    }

Ejemplo de pasar un array para `options`

El ejemplo anterior mostrará:

    int(493)
    bool(false)

Proporcionar flags directamente o vía un `array`

NULL
NULL