<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.filter-input-array" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">

<refnamediv>

<refname>filter_input_array</refname>

<refpurpose>Récupère plusieurs valeurs externes et les filtre</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>array</type><type>false</type><type>null</type></type><methodname>filter_input_array</methodname>

<methodparam><type>int</type><parameter>type</parameter></methodparam>

<methodparam choice="opt"><type class="union"><type>array</type><type>int</type></type><parameter>options</parameter><initializer><constant>FILTER_DEFAULT</constant></initializer></methodparam>

<methodparam choice="opt"><type>bool</type><parameter>add_empty</parameter><initializer>&true;</initializer></methodparam>

</methodsynopsis>

<para>

Cette fonction est utile pour récupérer plusieurs valeurs sans avoir

à appeler plusieurs fois la fonction <function>filter_input</function>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<variablelist>

<varlistentry>

<term><parameter>type</parameter></term>

<listitem>

<simpara>

Une des constantes <constant>INPUT_<replaceable>*</replaceable></constant>.

</simpara>

<warning>

<simpara>

Le contenu de la superglobale qui est filtrée est le contenu original

"brut" fourni par le <acronym>SAPI</acronym>,

avant toute modification utilisateur de la superglobale.

Pour filtrer une superglobale modifiée utiliser

<function>filter_var_array</function> à la place.

</simpara>

</warning>

</listitem>

</varlistentry>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.filter-var-array')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='options']]]/.)">

<xi:fallback/>

</xi:include>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.filter-var-array')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='add_empty']]]/.)">

<xi:fallback/>

</xi:include>

</variablelist>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<simpara>

En cas de succès, un &array; contenant les valeurs des variables demandées.

</simpara>

<simpara>

En cas d'échec, &false; est retourné.

Sauf si l'échec est que le tableau d'entrée désigné par

<parameter>type</parameter> n'est pas alimenté, auquel cas &null; est retourné

si le drapeau <constant>FILTER_NULL_ON_FAILURE</constant> est utilisé.

</simpara>

<simpara>

Les entrées manquantes du tableau d'entrée seront alimentées dans le &array;

retourné si <parameter>add_empty</parameter> est &true;.

Auquel cas, les entrées manquantes seront définies à &null;,

sauf si le drapeau <constant>FILTER_NULL_ON_FAILURE</constant> est utilisé,

dans quel cas ce sera &false;.

</simpara>

<simpara>

Une entrée dans le &array; retourné sera &false; si le filtre échoue,

sauf si le drapeau <constant>FILTER_NULL_ON_FAILURE</constant> est utilisé,

dans ce cas ça sera &null;.

</simpara>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<note>

<para>

Il n'y a pas de clé <literal>REQUEST_TIME</literal> dans le tableau

<constant>INPUT_SERVER</constant> car elle est insérée dans la

variable <varname>$_SERVER</varname> plus tard.

</para>

</note>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<simplelist>

<member><function>filter_input</function></member>

<member><function>filter_var</function></member>

<member><function>filter_var_array</function></member>

<member>

Les filtres de validation

<constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>

</member>

<member>

Les filtres de purification

<constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>

</member>

</simplelist>

</refsect1>

</refentry>