repo_zf1/documentation/manual/fr/module_specs/Zend_Validate-Alnum.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<sect2 id="zend.validate.set.alnum">
    <title>Alnum</title>

    <para>
        <classname>Zend_Validate_Alnum</classname> permet de valider des données contenant des
        caractères alphabétiques et des chiffres. Il n'y a pas de limite de taille.
    </para>

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

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

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>allowWhiteSpace</property></emphasis>: Si le caractère
                    d'espace doit êtyre accepté ou non. Par défaut <constant>FALSE</constant>
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.alnum.basic">
        <title>Utilisation de base</title>

        <para>
            Voici un exemple:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Alnum();
if ($validator->isValid('Abcd12')) {
    // value ne contient que des caractères autorisés
} else {
    // false
}
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.set.alnum.whitespace">
        <title>Utiliser les espaces</title>

        <para>
            Par défaut les caractères espaces ne sont pas acceptés car il ne font pas partie de l'alphabet.
            Cependant il existe un moyen de les accepter en entrée, ceci permet de valider des phrases
            complètes.
        </para>

        <para>
            Pour autoriser les espaces blancs vous devez passer l'option <property>allowWhiteSpace</property>.
            Ceci peut se faire à la création de l'objet ou après au moyen des méthodes
            <methodname>setAllowWhiteSpace()</methodname> et <methodname>getAllowWhiteSpace()</methodname>.
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Alnum(array('allowWhiteSpace' => true));
if ($validator->isValid('Abcd and 12')) {
    // value ne contient que des caractères autorisés
} else {
    // false
}
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.set.alnum.languages">
        <title>Utiliser des langues différentes</title>

        <para>
            En utilisant <classname>Zend_Validate_Alnum</classname>, la langue que l'utilisateur précise
            dans son navigateur sera utilisée pour autoriser ou non certains caractères. Ainsi si l'utilisateur
            règle son navigateur sur <emphasis>de</emphasis> pour de l'allemand, alors les caractères comme
            <emphasis>ä</emphasis>, <emphasis>ö</emphasis> et <emphasis>ü</emphasis> seront eux aussi
            autorisés.
        </para>

        <para>
            Les caractères autorisés dépendent donc complètement de la langue utilisée.
        </para>

        <para>
            Il existe actuellement 3 langues qui ne sont pas supportées pour ce validateur. Il s'agit
            de <emphasis>coréen</emphasis>, <emphasis>japonais</emphasis> et
            <emphasis>chinois</emphasis> car ces langues utilisent un alphabet dans lequel un seul
            caractère est fabriqué à base de multiples caractères.
        </para>

        <para>
            Dans le cas où vous utilisez ces langues, seule l'alphabet anglais sera utilisé pour la
            validation.
        </para>
    </sect3>
</sect2>
<!--
vim:se ts=4 sw=4 et:
-->