repo_zf1/documentation/manual/de/module_specs/Zend_Validate-Between.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 21554 -->
<!-- Reviewed: no -->
<sect2 id="zend.validate.set.between">
    <title>Between</title>

    <para>
        <classname>Zend_Validate_Between</classname> erlaubt es zu prüfen ob ein angegebener Wert
        zwischen zwei anderen Werten ist.
    </para>

    <note>
        <title>Zend_Validate_Between unterstützt nur die Prüfung von Nummern</title>

        <para>
            Es ist zu beachten das Zend_Validate_Between nur die Prüfung von Nummern unterstützt.
            Strings, oder ein Datum können mit dieser Prüfung nicht geprüft werden.
        </para>
    </note>

    <sect3 id="zend.validate.set.between.options">
        <title>Unterstützte Optionen für Zend_Validate_Between</title>

        <para>
            Die folgenden Optionen werden für <classname>Zend_Validate_Between</classname>
            unterstützt:
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>inclusive</property></emphasis>: Definiert ob die Prüfung
                    inklusive oder explusive der minimalen und maximalen Grenzwerte ist. Sie
                    ist standardmäßig <constant>TRUE</constant>.
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><property>max</property></emphasis>: Setzt die maximale Grenze für die
                    Prüfung.
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><property>min</property></emphasis>: Setzt die minimale Grenze für die
                    Prüfung.
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.between.basic">
        <title>Standardverhalten für Zend_Validate_Between</title>

        <para>
            Standardmäßig prüft diese Prüfung ob ein Wert zwischen <property>min</property> und
            <property>max</property> liegt wobei beide Grenzwerte als Wert erlaubt sind.
        </para>

        <programlisting language="php"><![CDATA[
$valid  = new Zend_Validate_Between(array('min' => 0, 'max' => 10));
$value  = 10;
$result = $valid->isValid($value);
// Gibt true zurück
]]></programlisting>

        <para>
            Im oben stehenden Beispiel ist das Ergebnis <constant>TRUE</constant> da die Suche
            standardmäßig inklusive den Grenzwerten stattfindet. Das bedeutet in unserem Fall das
            jeder Wert zwischen '0' und '10' erlaubt ist. Und Werte wie '-1' und '11' geben
            <constant>FALSE</constant> zurück.
        </para>
    </sect3>

    <sect3 id="zend.validate.set.between.inclusively">
        <title>Prüfung exklusive den Grenzwerten</title>

        <para>
            Manchmal ist es nützlich einen Wert zu prüfen wobei die Grenzwerte exkludiert werden.
            Siehe das folgende Beispiel:
        </para>

        <programlisting language="php"><![CDATA[
$valid  = new Zend_Validate_Between(
    array(
        'min' => 0,
        'max' => 10,
        'inclusive' => false
    )
);
$value  = 10;
$result = $valid->isValid($value);
// Gibt false zurück
]]></programlisting>

        <para>
            Das Beispiel ist fast so ähnlich wie unser erstes Beispiel, aber wir haben die
            Grenzwerte ausgeschlossen. Jetzt sind die Werte '0' und '10' nicht mehr erlaubt und
            geben <constant>FALSE</constant> zurück.
        </para>
    </sect3>
</sect2>