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

    <para>
        <classname>Zend_Filter_Alnum</classname> ist ein Filter welche nur alphabetische Zeichen und
        Ziffern zurückgibt. Alle anderen Zeichen werden unterdrückt.
    </para>

    <sect3 id="zend.filter.set.alnum.options">
        <title>Unterstützte Optionen für Zend_Filter_Alnum</title>

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

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>allowwhitespace</property></emphasis>: Wenn diese Option
                    gesetzt wird dann sind Leerzeichen erlaubt. Andernfalls werden Sie unterdrückt.
                    Standardmäßig sind Leerzeichen nicht erlaubt.
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.filter.set.alnum.basic">
        <title>Grundsätzliche Verwendung</title>

        <para>
            Das folgende Beispiel zeigt das Standardverhalten dieses Filters.
        </para>

        <programlisting language="php"><![CDATA[
$filter = new Zend_Filter_Alnum();
$return = $filter->filter('This is (my) content: 123');
// Gibt 'Thisismycontent123' zurück
]]></programlisting>

        <para>
            Das oben stehende Beispiel gibt 'Thisismycontent123' zurück. Wie man sehen kann werden
            alle Leerzeichen und auch die Klammern gefiltert.
        </para>

        <note>
            <para>
                <classname>Zend_Filter_Alnum</classname> arbeitet auf fast allen Sprachen. Aber
                aktuell gibt es drei Ausnahmen: Chinesisch, Japanisch und Koreanisch. In diesen
                Sprachen wird statt dessen das englische Alphabeth statt den Zeichen dieser Sprache
                verwendet. Die Sprache selbst wird durch Verwendung von
                <classname>Zend_Locale</classname> erkannt.
            </para>
        </note>
    </sect3>

    <sect3 id="zend.filter.set.alnum.whitespace">
        <title>Leerzeichen erlauben</title>

        <para>
            <classname>Zend_Filter_Alnum</classname> kann auch Leerzeichen erlauben. Das kann
            nützlich sein wenn man spezielle Zeichen von einem Text entfernen will. Siehe das
            folgende Beispiel:
        </para>

        <programlisting language="php"><![CDATA[
$filter = new Zend_Filter_Alnum(array('allowwhitespace' => true));
$return = $filter->filter('This is (my) content: 123');
// Gibt 'This is my content 123' zurück
]]></programlisting>

        <para>
            Das obige Beispiel gibt 'This is my content 123' zurück. Wie man sieht werden nur die
            Klammern gefiltert wobei die Leerzeichen nicht angefasst werden.
        </para>

        <para>
            Am <property>allowWhiteSpace</property> im Nachhinein zu ändern kann man
            <methodname>setAllowWhiteSpace</methodname> und
            <methodname>getAllowWhiteSpace</methodname> verwenden.
        </para>
    </sect3>
</sect2>
<!--
vim:se ts=4 sw=4 et:
-->
