[MANUAL] German:

- sync up to r21578

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@21582 44c647ce-9c0f-0410-b52a-842ac1e357ba

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

@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 21566 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.validate.set.iban">
+    <title>Iban</title>
+
+    <para>
+        <classname>Zend_Validate_Iban</classname> prüft ob ein angegebener Wert eine
+        <acronym>IBAN</acronym> Nummer sein könnte. <acronym>IBAN</acronym> ist die Abkürzung für
+        "International Bank Account Number".
+    </para>
+
+    <sect3 id="zend.validate.set.iban.options">
+        <title>Unterstützte Optionen für Zend_Validate_Iban</title>
+
+        <para>
+            Die folgenden Optionen werden für <classname>Zend_Validate_Iban</classname> unterstützt:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>locale</property></emphasis>: Setzt das Gebietsschema
+                    welches verwendet wird um das <acronym>IBAN</acronym> Format für die Prüfung zu
+                    erhalten.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.validate.set.iban.basic">
+        <title>IBAN Prüfung</title>
+
+        <para>
+            <acronym>IBAN</acronym> Nummern sind immer in Bezug zu einem Land. Dies bedeutet dass
+            unterschiedliche Länder unterschiedliche Formate für Ihre <acronym>IBAN</acronym>
+            Nummern verwenden. Das ist der Grund dafür warum <acronym>IBAN</acronym> nummern immer
+            ein Gebietsschema benötigen. Wenn wir dies wissen, dann wissen wir bereits wie wir
+            <classname>Zend_Validate_Iban</classname> verwenden können.
+        </para>
+
+        <sect4 id="zend.validate.set.iban.basic.application">
+            <title>Anwendungsweites Gebietsschema</title>
+
+            <para>
+                Wir können das Anwendungsweite Gebietsschema verwenden. Dass bedeutet, wenn keine
+                Option  bei der Instanzierung angegeben wird, das
+                <classname>Zend_Validate_Iban</classname> nach dem Anwendungsweiten Gebietsschema
+                sucht. Siehe den folgenden Codeabschnitt:
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// In der Bootstrap
+Zend_Registry::set('Zend_Locale', new Zend_Locale('de_AT'));
+
+// Im Modul
+$validator = new Zend_Validate_Iban();
+
+if ($validator->isValid('AT611904300234573201')) {
+    // IBAN scheint gültig zu sein
+} else {
+    // IBAN ist ungültig
+}
+]]></programlisting>
+
+            <note>
+                <title>Anwendungsweites Gebietsschema</title>
+
+                <para>
+                    Natürlich funktioniert dies nur wenn das Anwendungsweite Gebietsschema in der
+                    Registry vorher gesetzt wurde. Andernfalls wird
+                    <classname>Zend_Locale</classname> versuchen das Gebietsschema zu verwenden
+                    welches der Client sendet, oder wenn keines gesendet wurde, das Gebietsschema
+                    der Umgebung. Man sollte darauf achten das dies zu ungewünschtem Verhalten bei
+                    der Prüfung führen kann.
+                </para>
+            </note>
+        </sect4>
+
+        <sect4 id="zend.validate.set.iban.basic.false">
+            <title>Unscharfe IBAN Prüfung</title>
+
+            <para>
+                Manchmal ist es nützlich, nur zu prüfen ob der angegebene Wert eine
+                <acronym>IBAN</acronym> Nummer <emphasis>ist</emphasis> oder nicht. Das bedeutet
+                das man nicht auf ein definiertes Land prüfen will. Das kann getan werden indem ein
+                <constant>FALSE</constant> als Gebietsschema verwendet wird.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Iban(array('locale' => false));
+// Achtung: Man kann ein FALSE auch als einzelnen Parmeter setzen
+
+if ($validator->isValid('AT611904300234573201')) {
+    // IBAN scheint gültig zu sein
+} else {
+    // IBAN ist nicht gültig
+}
+]]></programlisting>
+
+            <para>
+                So wird <emphasis>jede</emphasis> <acronym>IBAN</acronym> Nummer gültig sein. Es
+                ist zu beachten dass man dies nicht tun sollte wenn man nur Konten von einem
+                einzelnen Land akzeptiert.
+            </para>
+        </sect4>
+
+        <sect4 id="zend.validate.set.iban.basic.aware">
+            <title>Gebietsschema verwendende IBAN Prüfung</title>
+
+            <para>
+                Um gegen ein definiertes Land zu prüfen muss man nur das gewünschte Gebietsschema
+                angeben. Man kann dies mit der <property>locale</property> Option tun, und bei
+                Verwendung von <methodname>setLocale()</methodname> auch im Nachhinein.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Iban(array('locale' => 'de_AT'));
+
+if ($validator->isValid('AT611904300234573201')) {
+    // IBAN scheint gültig zu sein
+} else {
+    // IBAN ist ungültig
+}
+]]></programlisting>
+
+            <note>
+                <title>Vollständig qualifizierte Gebietsschemas verwenden</title>
+
+                <para>
+                    Man muss ein vollständig qualifiziertes Gebietsschema verwenden. Andernfalls
+                    kann das Land nicht korrekt erkannt werden, da gleiche Sprachen in mehreren
+                    Ländern gesprochen werden.
+                </para>
+            </note>
+        </sect4>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 21556 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.validate.set.int">
+    <title>Int</title>
+
+    <para>
+        <classname>Zend_Validate_Int</classname> prüft ob ein angegebener Wert ein Integer
+        (Ganzzahl) ist. Auch lokalisierte Integerwerte werden erkannt und können geprüft werden.
+    </para>
+
+    <sect3 id="zend.validate.set.int.options">
+        <title>Unterstützte Optionen für Zend_Validate_Int</title>
+
+        <para>
+            Die folgenden Optionen werden für <classname>Zend_Validate_Int</classname> unterstützt:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>locale</property></emphasis>: Setzt das Gebietsschema
+                    welches verwendet wird um lokalisierte Integerwerte zu prüfen.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.validate.set.int.basic">
+        <title>Einfache Integer Prüfung</title>
+
+        <para>
+            Der einfachste Weg um einen Integerwert zu prüfen ist die Verwendung der
+            Systemeinstellungen. Wenn keine Optionen angegeben werden, dann wird das Gebietsschema
+            der Umgebung für die Prüfung verwendet:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Int();
+
+$validator->isValid(1234);   // Gibt true zurück
+$validator->isValid(1234.5); // Gibt false zurück
+$validator->isValid('1,234'); // Gibt true zurück
+]]></programlisting>
+
+        <para>
+            Um obigen Beispiel haben wir angenommen das unsere Umgebung auf "en" als Gebietsschema
+            gesetzt ist. Wie man im dritten Beispiel sieht wird auch die Gruppierung erkannt.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.validate.set.int.localized">
+        <title>Lokalisierte Integer Prüfung</title>
+
+        <para>
+            Oft ist es nützlich dazu in der Lage zu sein lokalisierte Werte zu prüfen. Integerwerte
+            werden in anderen Ländern oft unterschiedlich geschrieben. Zum Beispiel kann man im
+            Englischen  "1234" oder "1,234" schreiben. Beides sind Integerwerte, aber die
+            Gruppierung ist optional. Im Deutschen kann man zum Beispiel "1.234" schreiben und im
+            Französischen "1 234".
+        </para>
+
+        <para>
+            <classname>Zend_Validate_Int</classname> ist in der Lage solche Schreibweisen zu prüfen.
+            Das bedeutet, das es nicht einfach das Trennzeichen entfernt, sondern auch prüft ob das
+            richtige Trennzeichen verwendet wird. Siehe den folgenden Code:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Int(array('locale' => 'de'));
+
+$validator->isValid(1234); // Gibt true zurück
+$validator->isValid("1,234"); // Gibt false zurück
+$validator->isValid("1.234"); // Gibt true zurück
+]]></programlisting>
+
+        <para>
+            Wie man sieht wird die Eingabe, bei Verwendung eines Gebietsschemas, lokalisiert
+            geprüft. Bei Verwendung der englischen Schreibweise erhält man
+            <constant>FALSE</constant> wenn das Gebietsschema eine andere Schreibweise erzwingt.
+        </para>
+
+        <para>
+            Das Gebietsschema kann auch im Nachhinein gesetzt werden indem
+            <methodname>setLocale()</methodname> verwendet wird, und empfangen indem man
+            <methodname>getLocale()</methodname> verwendet.
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21501 -->
+<!-- EN-Revision: 21562 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>Standard Prüfklassen</title>
@@ -98,77 +98,10 @@
     <xi:include href="Zend_Validate-GreaterThan.xml" />
     <xi:include href="Zend_Validate-Hex.xml" />
     <xi:include href="Zend_Validate-Hostname.xml" />
-
-    <sect2 id="zend.validate.set.iban">
-        <title>Iban</title>
-
-        <para>
-            Gibe nur dann <constant>TRUE</constant> zurück wenn <varname>$value</varname> eine
-            gültige IBAN (Internationale Bank Account Nummer) enthält. IBAN Nummern werden gegen ein
-            Land geprüft in dem Sie verwendet werden und durch eine Checksumme.
-        </para>
-
-        <para>
-            Es gibt zwei Wege um IBAN Nummern zu prüfen. Als ersten Weg kann man ein Gebietsschema
-            angeben welches das Land repräsentiert. Jede angegebene IBAN Nummer wird das gegen
-            dieses Land geprüft.
-        </para>
-
-        <programlisting language="php"><![CDATA[
-$validator = new Zend_Validate_Iban('de_AT');
-$iban = 'AT611904300234573201';
-if ($validator->isValid($iban)) {
-    // IBAN scheint gültig zu sein
-} else {
-    // IBAN ist ungültig
-    foreach ($validator->getMessages() as $message) {
-        echo "$message\n";
-    }
-}
-]]></programlisting>
-
-        <para>
-            Das sollte man tun wenn man IBAN Nummern gegen ein einzelnes Land prüfen will. Der
-            einfachere Weg der Prüfung ist es kein Gebietsschema anzugeben wie im nächsten Beispiel
-            gezeigt.
-        </para>
-
-        <programlisting language="php"><![CDATA[
-$validator = new Zend_Validate_Iban();
-$iban = 'AT611904300234573201';
-if ($validator->isValid($iban)) {
-    // IBAN scheint gültig zu sein
-} else {
-    // IBAN ist ungültig
-}
-]]></programlisting>
-
-        <para>
-            Aber das zeigt ein großes Problem: Wenn man nur IBAN Nummern von einem einzelnen Land
-            akzeptieren darf, zum Beispiel Frankreich, sind auch die IBAN Nummer von anderen Ländern
-            gültig. Deshalb als Erinnerung: Wenn man IBAN Nummern gegen ein definiertes Land zu
-            prüfen hat, sollte man ein Gebietsschema angeben. Und wenn man alle IBAN Nummern
-            akzeptieren will unabhängig von irgendeinem Land kann der Einfachheit halber das
-            Gebietsschema unterdrückt werden.
-        </para>
-    </sect2>
-
+    <xi:include href="Zend_Validate-Iban.xml" />
     <xi:include href="Zend_Validate-Identical.xml" />
     <xi:include href="Zend_Validate-InArray.xml" />
-
-    <sect2 id="zend.validate.set.int">
-        <title>Int</title>
-
-        <para>
-            Gibt nur dann <constant>TRUE</constant> zurück wenn <varname>$value</varname> ein
-            gültiger Integer ist. Seit Zend Framework 1.8 verwendet diese Prüfung auch das aktuelle
-            Gebietsschema des Browsers, der Umgebung oder eines anwendungsweit gesetzten
-            Gebietsschemas. Man kann natürlich die Zugriffsmethoden get/setLocale verwenden um das
-            verwendete Gebietsschema zu verändern oder es bei der Erstellung einer Instanz dieser
-            Prüfung angeben.
-        </para>
-    </sect2>
-
+    <xi:include href="Zend_Validate-Int.xml" />
     <xi:include href="Zend_Validate-Isbn.xml" />
     <xi:include href="Zend_Validate-Ip.xml" />
     <xi:include href="Zend_Validate-LessThan.xml" />