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

    <para>
        <classname>Zend_Filter_Alpha</classname> ist ein Filter der den String
        <varname>$value</varname> zurückgibt, wobei er alle Zeichen entfernt die keine
        alphabetischen Zeichen sind. Dieser Filter enthält eine Option welche Leerzeichen
        erlaubt.
    </para>

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

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

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

    <sect3 id="zend.filter.set.alpha.basic">
        <title>Einfache Verwendung</title>

        <para>
            Ein einfaches Beispiel der Verwendung ist anbei:
        </para>

        <programlisting language="php"><![CDATA[
$filter = new Zend_Filter_Alpha();

print $filter->filter('Das ist (mein) Inhalt: 123');
]]></programlisting>

        <para>
            Das obige Beispiel gibt 'DasistmeinInhalt' zurück. Es sollte beachtet werden dass
            Leerzeichen und Klammern entfernt werden.
        </para>

        <note>
            <para>
                <classname>Zend_Filter_Alpha</classname> arbeitet mit den meisten Sprachen; trotzdem
                gibt es drei Ausnahmen: Chinesisch, Japanisch und Koreanisch. Bei diesen Sprachen
                wird das englische Alphabeth verwenden. Die Sprache wird durch die Verwendung von
                <classname>Zend_Locale</classname> erkannt.
            </para>
        </note>
    </sect3>

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

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

        <programlisting language="php"><![CDATA[
$filter = new Zend_Filter_Alpha(array('allowwhitespace' => true));

print $filter->filter('Das ist (mein) Inhalt: 123');
]]></programlisting>

        <para>
            Das oben stehende Beispiel gibt 'Das ist mein Inhalt ' zurück. Es ist zu beachten das
            alle Klammern, Doppelpunkte und Zahlen entfernt werden während die Leerzeichen bleiben.
        </para>

        <para>
            Um <property>allowWhiteSpace</property> nach der Instanziierung zu ändern kann die
            Methode <methodname>setAllowWhiteSpace()</methodname> verwendet werden.
        </para>

        <para>
            Um den aktuellen Wert von <property>allowWhiteSpace</property> zu erhalten kann die
            Methode <methodname>getAllowWhiteSpace()</methodname> verwendet werden.
        </para>
    </sect3>
</sect2>
<!--
vim:se ts=4 sw=4 et:
-->
