File: Zend_Validate-Between.xml

package info (click to toggle)
zendframework 1.12.9%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie-kfreebsd
  • size: 133,584 kB
  • sloc: xml: 1,311,829; php: 570,173; sh: 170; makefile: 125; sql: 121
file content (105 lines) | stat: -rw-r--r-- 3,609 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- 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 <classname>Zend_Validate_Between</classname> 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>