repo_zf1/documentation/manual/de/module_specs/Zend_Validate-Alpha.xml

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

    <para>
        <classname>Zend_Validate_Alpha</classname> erlaubt es zu prüfen ob ein angegebener Wert nur
        alphabetische Zeichen enthält. Es gibt keine Begrenzung der Länge für die Eingabe welche man
        prüfen will. Diese Prüfung ist ähnlich wie die <classname>Zend_Validate_Alnum</classname>
        Prüfung mit der Ausnahme dass Sie keine Ziffern akzeptiert.
    </para>

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

        <para>
            Die folgenden Optionen werden von <classname>Zend_Validate_Alpha</classname>
            unterstützt:
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>allowWhiteSpace</property></emphasis>: Ob Leerzeichen
                    erlaubt sind. Diese Option ist standardmäßig <constant>FALSE</constant>
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.alpha.basic">
        <title>Standardverhalten</title>

        <para>
            Das folgende ist ein standardmäßiges Beispiel:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Alpha();
if ($validator->isValid('Abcd')) {
    // Der Wert enthält nur erlaubte Zeichen
} else {
    // false
}
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.set.alpha.whitespace">
        <title>Verwendung von Leerzeichen</title>

        <para>
            Standardmäßig werden Leerzeichen nicht akzeptiert weil Sie nicht Teil des Alphabeths
            sind. Trotzdem gibt es einen Weg Sie als Eingabe zu akzeptieren. Das erlaubt es
            komplette Sätze oder Phrasen zu prüfen.
        </para>

        <para>
            Um die Verwendung von Leerzeichen zu erlauben muss man die Option
            <property>allowWhiteSpace</property> angeben. Das kann während der Erstellung einer
            Instanz des Prüfers getan werden, oder im Nachhinein indem
            <methodname>setAllowWhiteSpace()</methodname> verwendet wird. Um den aktuellen Zustand
            zu erhalten kann <methodname>getAllowWhiteSpace()</methodname> verwendet werden.
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Alpha(array('allowWhiteSpace' => true));
if ($validator->isValid('Abcd and efg')) {
    // Der Wert enthält nur erlaubte Zeichen
} else {
    // false
}
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.set.alpha.languages">
        <title>Andere Sprachen verwenden</title>

        <para>
            Wenn <classname>Zend_Validate_Alpha</classname> verwendet wird dann wird jene Sprache
            verwendet, welche der Benutzer in seinem Browser gesetzt hat, um die erlaubten Zeichen
            zu setzen. Das bedeutet, wenn ein Benutzer <emphasis>de</emphasis> für Deutsch setzt
            dann kann er auch Zeichen wie <emphasis>ä</emphasis>, <emphasis>ö</emphasis> und
            <emphasis>ü</emphasis> zusätzlich zu den Zeichen des englischen Alphabeths setzen.
        </para>

        <para>
            Welche Zeichen erlaubt sind hängt komplett von der verwendeten Sprache ab, da jede
            Sprache Ihr eigenes Set von Zeichen definiert.
        </para>

        <para>
            Es gibt aktuell 3 Sprachen welche nicht mit Ihrer eigenen Schreibweise akzeptiert
            werden. Diese Sprachen sind <emphasis>koreanisch</emphasis>,
            <emphasis>japanisch</emphasis> und <emphasis>chinesisch</emphasis>, da diese Sprachen
            ein Alphabeth verwenden bei dem einzelne Zeichen so aufgebaut werden dass Sie mehrere
            Zeichen verwenden.
        </para>

        <para>
            Im Falle das diese Sprachen verwendet werden wird der Inhalt nur durch Verwendung des
            englischen Alphabeths geprüft.
        </para>
    </sect3>
</sect2>