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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 21987 -->
   3 <!-- Reviewed: no -->
   4 <sect2 id="zend.validate.set.alpha">
   5     <title>Alpha</title>
   6
   7     <para>
   8         <classname>Zend_Validate_Alpha</classname> erlaubt es zu prüfen ob ein angegebener Wert nur
   9         alphabetische Zeichen enthält. Es gibt keine Begrenzung der Länge für die Eingabe welche man
  10         prüfen will. Diese Prüfung ist ähnlich wie die <classname>Zend_Validate_Alnum</classname>
  11         Prüfung mit der Ausnahme dass Sie keine Ziffern akzeptiert.
  12     </para>
  13
  14     <sect3 id="zend.validate.set.alpha.options">
  15         <title>Unterstützte Optionen für Zend_Validate_Alpha</title>
  16
  17         <para>
  18             Die folgenden Optionen werden von <classname>Zend_Validate_Alpha</classname>
  19             unterstützt:
  20         </para>
  21
  22         <itemizedlist>
  23             <listitem>
  24                 <para>
  25                     <emphasis><property>allowWhiteSpace</property></emphasis>: Ob Leerzeichen
  26                     erlaubt sind. Diese Option ist standardmäßig <constant>FALSE</constant>
  27                 </para>
  28             </listitem>
  29         </itemizedlist>
  30     </sect3>
  31
  32     <sect3 id="zend.validate.set.alpha.basic">
  33         <title>Standardverhalten</title>
  34
  35         <para>
  36             Das folgende ist ein standardmäßiges Beispiel:
  37         </para>
  38
  39         <programlisting language="php"><![CDATA[
  40 $validator = new Zend_Validate_Alpha();
  41 if ($validator->isValid('Abcd')) {
  42     // Der Wert enthält nur erlaubte Zeichen
  43 } else {
  44     // false
  45 }
  46 ]]></programlisting>
  47     </sect3>
  48
  49     <sect3 id="zend.validate.set.alpha.whitespace">
  50         <title>Verwendung von Leerzeichen</title>
  51
  52         <para>
  53             Standardmäßig werden Leerzeichen nicht akzeptiert weil Sie nicht Teil des Alphabeths
  54             sind. Trotzdem gibt es einen Weg Sie als Eingabe zu akzeptieren. Das erlaubt es
  55             komplette Sätze oder Phrasen zu prüfen.
  56         </para>
  57
  58         <para>
  59             Um die Verwendung von Leerzeichen zu erlauben muss man die Option
  60             <property>allowWhiteSpace</property> angeben. Das kann wärend der Erstellung einer
  61             Instanz des Prüfers getan werden, oder im Nachhinein indem
  62             <methodname>setAllowWhiteSpace()</methodname> verwendet wird. Um den aktuellen Zustand
  63             zu erhalten kann <methodname>getAllowWhiteSpace()</methodname> verwendet werden.
  64         </para>
  65
  66         <programlisting language="php"><![CDATA[
  67 $validator = new Zend_Validate_Alpha(array('allowWhiteSpace' => true));
  68 if ($validator->isValid('Abcd and efg')) {
  69     // Der Wert enthält nur erlaubte Zeichen
  70 } else {
  71     // false
  72 }
  73 ]]></programlisting>
  74     </sect3>
  75
  76     <sect3 id="zend.validate.set.alpha.languages">
  77         <title>Andere Sprachen verwenden</title>
  78
  79         <para>
  80             Wenn <classname>Zend_Validate_Alpha</classname> verwendet wird dann wird jene Sprache
  81             verwendet, welche der Benutzer in seinem Browser gesetzt hat, um die erlaubten Zeichen
  82             zu setzen. Das bedeutet, wenn ein Benutzer <emphasis>de</emphasis> für Deutsch setzt
  83             dann kann er auch Zeichen wie <emphasis>ä</emphasis>, <emphasis>ö</emphasis> und
  84             <emphasis>ü</emphasis> zusätzlich zu den Zeichen des englischen Alphabeths setzen.
  85         </para>
  86
  87         <para>
  88             Welche Zeichen erlaubt sind hängt komplett von der verwendeten Sprache ab, da jede
  89             Sprache Ihr eigenes Set von Zeichen definiert.
  90         </para>
  91
  92         <para>
  93             Es gibt aktuell 3 Sprachen welche nicht mit Ihrer eigenen Schreibweise akzeptiert
  94             werden. Diese Sprachen sind <emphasis>koreanisch</emphasis>,
  95             <emphasis>japanisch</emphasis> und <emphasis>chinesisch</emphasis>, da diese Sprachen
  96             ein Alphabeth verwenden bei dem einzelne Zeichen so aufgebaut werden dass Sie mehrere
  97             Zeichen verwenden.
  98         </para>
  99
 100         <para>
 101             Im Falle das diese Sprachen verwendet werden wird der Inhalt nur durch Verwendung des
 102             englischen Alphabeths geprüft.
 103         </para>
 104     </sect3>
 105 </sect2>