<?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>Nimmt mehrere Variablen von Außen entgegen und filtert sie optional</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>

Diese Funktion ist nützlich, um mehrere Werte abzufragen ohne wiederholend

<function>filter_input</function> aufrufen zu müssen.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<variablelist>

<varlistentry>

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

<listitem>

<simpara>

Eine der <constant>INPUT_<replaceable>*</replaceable></constant>-Konstanten.

</simpara>

<warning>

<simpara>

Der Inhalt der zu filternden Superglobalen ist der ursprüngliche "rohe"

Inhalt, der von der <acronym>SAPI</acronym> bereitgestellt wird, &dh;

bevor die Superglobale verändert wurde.

Um eine geänderte Superglobale zu filtern, sollte stattdessen

<function>filter_var_array</function> verwendet werden.

</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>

Gibt bei Erfolg ein &array; mit den Werten der angeforderten Variablen aus.

</simpara>

<simpara>

Im Fehlerfall wird &false; zurückgegeben, es sei denn, der Fehler besteht

darin, dass das durch <parameter>type</parameter> bezeichnete Eingabe-Array

nicht gefüllt ist. In diesem Fall wird &null; zurückgegeben, wenn das Flag

<constant>FILTER_NULL_ON_FAILURE</constant> verwendet wird.

</simpara>

<simpara>

Wenn <parameter>add_empty</parameter> &true; ist, werden fehlende Einträge

aus dem Eingabe-Array in das zurückgegebene &array; eingefügt.

In diesem Fall werden fehlende Einträge auf &null; gesetzt, es sei denn, das

Flag <constant>FILTER_NULL_ON_FAILURE</constant> wird verwendet, in diesem

Fall ist es &false;.

</simpara>

<simpara>

Ein Eintrag des zurückgegebenen &array; wird auf &false; gesetzt, wenn der

Filter fehlschlägt, es sei denn, das Flag

<constant>FILTER_NULL_ON_FAILURE</constant> wird verwendet; in diesem Fall

wird er auf &null; gesetzt.

</simpara>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<note>

<para>

Es gibt keinen <literal>REQUEST_TIME</literal>-Key im Array

<constant>INPUT_SERVER</constant>, weil dieser erst später in

<varname>$_SERVER</varname> eingefügt wird.

</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>

Validierungsfilter

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

</member>

<member>

Bereinigungsfilter

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

</member>

</simplelist>

</refsect1>

</refentry>