File: Zend_Validate-Int.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 (87 lines) | stat: -rw-r--r-- 3,272 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
<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect2 id="zend.validate.set.int">
    <title>Int</title>

    <para>
        <classname>Zend_Validate_Int</classname> valide une valeur envers un entier. Les entiers localisés sont
        aussi gérés.
    </para>

    <sect3 id="zend.validate.set.int.options">
        <title>Options supportées par Zend_Validate_Int</title>

        <para>
            Les options suivantes sont supportées par <classname>Zend_Validate_Int</classname>:
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>locale</property></emphasis>: Affecte la locale à utiliser lors de la
                    validation.
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.int.basic">
        <title>Validation simple d'entiers</title>

        <para>
            La manière la plus simple de valider un entier est d'utiliser les paramètres systèmes. Lorsqu'aucune
            option n'est passée, la locale de l'environnement sera utilisée:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Int();

$validator->isValid(1234);   // retourne true
$validator->isValid(1234.5); // retourne false
$validator->isValid('1,234'); // retourne true
]]></programlisting>

        <para>
            Dans l'exemple ci-dessus l'environnement est supposé réglé sur la locale "en". Comme vous le voyez,
            le regroupement de chiffres est supporté (troisième exemple).
        </para>
    </sect3>

    <sect3 id="zend.validate.set.int.localized">
        <title>Validation d'entiers localisés</title>

        <para>
            Il est parfois nécessaire de valider des entiers localisés. Les entiers sont souvent écrits de
            manière différente en fonction des pays/régions. Par exemple en anglais vous pouvez écrire "1234"
            ou "1,234", ce sont tous les deux des entiers mais le regroupement des chiffres est optionnel.
            En allemand, vous écririez "1.234" et en français "1 234".
        </para>

        <para>
            <classname>Zend_Validate_Int</classname> peut valider de telles notations. Il est limité à la locale
            utilisée et valide le séparateur utilisé en fonction de la locale. Voyez le code ci-après:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Int(array('locale' => 'de'));

$validator->isValid(1234); // retourne true
$validator->isValid("1,234"); // retourne false
$validator->isValid("1.234"); // retourne true
]]></programlisting>

        <para>
            Comme vous le voyez, avec une locale, l'entrée est validée en fonction de la locale. En utilisant
            l'anglais, vous récupérez <constant>FALSE</constant> lorsque la locale force une notation différente.
        </para>

        <para>
            La locale peut être affectée/récupérée après la création du validateur au moyen des méthodes
            <methodname>setLocale()</methodname> et <methodname>getLocale()</methodname>.
        </para>
    </sect3>
</sect2>
<!--
vim:se ts=4 sw=4 et:
-->