svn: /phpdoc/de/trunk/ features/commandline.xml language/generators.xml reference/array/functions/list.xml reference/datetime/functions/strtotime.xml reference/strings/functions/chr.xml reference/strings/functions/ord.xml reference/var/functions/is-string.xml

Modified: phpdoc/de/trunk/features/commandline.xml
===================================================================
--- phpdoc/de/trunk/features/commandline.xml	2018-07-02 10:13:14 UTC (rev 345262)
+++ phpdoc/de/trunk/features/commandline.xml	2018-07-02 13:54:42 UTC (rev 345263)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 339251 Maintainer: nikic Status: ready -->
+<!-- EN-Revision: 345240 Maintainer: nikic Status: ready -->
 <!-- Credits: hholzgra, fa -->

 <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -1411,6 +1411,8 @@
    Seit PHP 5.1.0 bietet die &cli.sapi; mit der <option>-a</option> Option
    eine interaktive Shell an, wenn PHP mit der <option
    role="configure">--with-readline</option> Option kompiliert wurde.
+   Von PHP 7.1.0 an steht die interaktive Shell auch unter Windows zu Verfügung,
+   wenn die <link linkend="book.readline">readline Extension</link> aktiviert ist.
   </para>

   <para>

Modified: phpdoc/de/trunk/language/generators.xml
===================================================================
--- phpdoc/de/trunk/language/generators.xml	2018-07-02 10:13:14 UTC (rev 345262)
+++ phpdoc/de/trunk/language/generators.xml	2018-07-02 13:54:42 UTC (rev 345263)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 344528 Maintainer: cmb Status: ready -->
+<!-- EN-Revision: 345249 Maintainer: cmb Status: ready -->

 <chapter xml:id="language.generators" xmlns="http://docbook.org/ns/docbook">
  <title>Generatoren</title>
@@ -101,7 +101,7 @@
   <sect2 xml:id="language.generators.object">
    <title><classname>Generator</classname>-Objekte</title>
    <para>
-    Beim ersten Aufruf einer Generatorfunktion wird ein Objekt der internen
+    Beim Aufruf einer Generatorfunktion wird ein neues Objekt der internen
     <classname>Generator</classname>-Klasse zurückgegeben. Dieses Objekt
     implementiert das <classname>Iterator</classname>-Interface in gleicher
     Weise wie es ein forward-only Iterator-Objekt machen würde und stellt
@@ -125,14 +125,14 @@
    Wenn eine Generatorfunktion aufgerufen wird, wird ein Objekt zurückgegeben,
    über das iteriert werden kann.
    Wenn Sie über dieses Objekt iterieren (zum Beispiel, per
-   &foreach;-Schleife), wird PHP die Generatorfunktion jedesmal aufrufen, wenn ein
+   &foreach;-Schleife), wird PHP die Iteratorfunktionen des Objekts jedesmal aufrufen, wenn ein
    Wert benötigt wird. Dann wird der Status des Generators gesichert,
    so dass fortgefahren werden kann, wenn der nächste Wert benötigt wird.
   </para>

   <para>
-   Sobald keine weiteren Werte zurückgegeben werden können, kann die
-   Generatorfunktion einfach beendet werden, und der rufende Code wird
+   Sobald keine weiteren Werte zurückgegeben werden können, kann der
+   Generator einfach beendet werden, und der rufende Code wird
    fortgesetzt, als gäbe es keine weiteren Werte in einem Array.
   </para>


Modified: phpdoc/de/trunk/reference/array/functions/list.xml
===================================================================
--- phpdoc/de/trunk/reference/array/functions/list.xml	2018-07-02 10:13:14 UTC (rev 345262)
+++ phpdoc/de/trunk/reference/array/functions/list.xml	2018-07-02 13:54:42 UTC (rev 345263)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 340033 Maintainer: cmb Status: ready -->
+<!-- EN-Revision: 345209 Maintainer: cmb Status: ready -->
 <!-- CREDITS: tom -->

 <refentry xml:id="function.list" xmlns="http://docbook.org/ns/docbook">
@@ -24,8 +24,8 @@
   </para>
   <note>
    <para>
-    <function>list</function> funktioniert nur bei numerischen Arrays und
-    basiert auf der Annahme, dass die numerischen Indizes bei 0 beginnen.
+    Vor PHP 7.1.0 funktionierte <function>list</function> nur bei numerischen Arrays und
+    basierte auf der Annahme, dass die numerischen Indizes bei 0 beginnen.
    </para>
   </note>
   <warning>
@@ -91,6 +91,14 @@
      </thead>
      <tbody>
       <row>
+       <entry>7.1.0</entry>
+       <entry>
+        Es ist nun möglich Schlüssel in <function>list</function> anzugeben. Dies
+        ermöglicht die Destrukturierung von Arrays mit nicht numerischen oder
+        nicht fortlaufenden Schlüsseln.
+       </entry>
+      </row>
+      <row>
        <entry>7.0.0</entry>
        <entry>
         <link linkend="migration70.incompatible.variable-handling.list.order">
@@ -291,6 +299,41 @@
     </screen>
    </example>
   </para>
+  <para>
+   <example>
+    <title><function>list</function> mit Schlüsseln</title>
+    <simpara>
+     Von PHP 7.1.0 an kann <function>list</function> nun ebenfalls explizite
+     Schlüssel enthalten, die als beliebige Ausdrücke angegeben werden können.
+     Die Kombination von Integer- und Zeichenkettenschlüsseln ist erlaubt;
+     allerdings dürfen Elemente mit und ohne Schlüssel nicht kombiniert werden.
+    </simpara>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$data = [
+    ["id" => 1, "name" => 'Tom'],
+    ["id" => 2, "name" => 'Fred'],
+];
+foreach ($data as ["id" => $id, "name" => $name]) {
+    echo "id: $id, name: $name\n";
+}
+echo PHP_EOL;
+list(1 => $second, 3 => $fourth) = [1, 2, 3, 4];
+echo "$second, $fourth\n";
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+id: 1, name: Tom
+id: 2, name: Fred
+
+2, 4
+]]>
+    </screen>
+   </example>
+  </para>
  </refsect1>

  <refsect1 role="seealso">

Modified: phpdoc/de/trunk/reference/datetime/functions/strtotime.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/strtotime.xml	2018-07-02 10:13:14 UTC (rev 345262)
+++ phpdoc/de/trunk/reference/datetime/functions/strtotime.xml	2018-07-02 13:54:42 UTC (rev 345263)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 337698 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 345236 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.strtotime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>

Modified: phpdoc/de/trunk/reference/strings/functions/chr.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/chr.xml	2018-07-02 10:13:14 UTC (rev 345262)
+++ phpdoc/de/trunk/reference/strings/functions/chr.xml	2018-07-02 13:54:42 UTC (rev 345263)
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 339802 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 345229 Maintainer: sammywg Status: ready -->

 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.chr">
  <refnamediv>
   <refname>chr</refname>
-  <refpurpose>Gibt ein einzelnes Zeichen zurück</refpurpose>
+  <refpurpose>Erzeuge eine Ein-Byte-Zeichenkette aus einer Zahl</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -12,13 +12,22 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>chr</methodname>
-   <methodparam><type>int</type><parameter>ascii</parameter></methodparam>
+   <methodparam><type>int</type><parameter>bytevalue</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Gibt einen Ein-Zeichen-String zurück, der dem angegebenen
-   <parameter>ascii</parameter>-Wert entspricht.
+   Gibt einen Ein-Zeichen-String zurück, der das angegebene Zeichen enthält, wobei
+   <parameter>bytevalue</parameter> als vorzeichenlose Ganzzahl interpretiert wird.
   </para>
   <para>
+   Dies kann verwendet werden, um einen Ein-Zeichen-String in einer
+   Ein-Byte-Kodierung wie ASCII, ISO-8859 oder Windows 1252 zu erzeugen, indem
+   die Position des gewünschten Zeichens in der Kodierungszuordnungstabelle
+   übergeben wird. Allerdings ist zu beachten, dass diese Funktion die
+   Zeichenkettenkodierung ignoriert, und insbesondere kein Unicode Code-Point
+   übergeben werden kann, um eine Zeichenkette in einer Multi-Byte-Kodierung wie
+   UTF-8 oder UTF-16 zu erzeugen.
+  </para>
+  <para>
    Die Funktion ergänzt <function>ord</function>.
   </para>
  </refsect1>
@@ -28,10 +37,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>ascii</parameter></term>
+     <term><parameter>bytevalue</parameter></term>
      <listitem>
       <para>
-       Der erweiterte ASCII-Code.
+       Ein Integer zwischen 0 und 255.
       </para>
       <para>
        Werte außerhalb des gültigen Bereichs (0..255) werden bitweise mit 255
@@ -38,10 +47,10 @@
        und-verknüpft, was gleichwertig zu folgendem Algorithmus ist:
        <programlisting role="php">
 <![CDATA[
-while ($ascii < 0) {
-    $ascii += 256;
+while ($bytevalue < 0) {
+    $bytevalue += 256;
 }
-$ascii %= 256;
+$bytevalue %= 256;
 ]]>
        </programlisting>
       </para>
@@ -54,7 +63,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Gibt das angegebene Zeichen zurück.
+   Ein Ein-Zeichen-String, der das angegebene Byte enthält.
   </para>
  </refsect1>

@@ -66,6 +75,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+// Es wird angenommen, dass die Zeichenkette als ASCII oder ASCII-kompatible Kodierung verwendet wird
 $str = "Dieser String endet mit einem Escape-Zeichen: ";
 $str .= chr(27); /* fügt das Escape-Zeichen an das Ende von $str an */

@@ -93,6 +103,24 @@
     </screen>
    </example>
   </para>
+  <para>
+   <example>
+    <title>Erstellen eines UTF-8-String aus einzelnen Bytes</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+declare(encoding='UTF-8');
+$str = chr(240) . chr(159) . chr(144) . chr(152);
+echo $str;
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+🐘
+    </screen>
+   </example>
+  </para>
  </refsect1>

  <refsect1 role="seealso">

Modified: phpdoc/de/trunk/reference/strings/functions/ord.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/ord.xml	2018-07-02 10:13:14 UTC (rev 345262)
+++ phpdoc/de/trunk/reference/strings/functions/ord.xml	2018-07-02 13:54:42 UTC (rev 345263)
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 345229 Maintainer: sammywg Status: ready -->
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.ord">
  <refnamediv>
   <refname>ord</refname>
-  <refpurpose>Gibt den ASCII-Wert eines Zeichens zurück</refpurpose>
+  <refpurpose>Konvertiere das erst Byte einer Zeichenkette in einen Wert zwischen 0 und 255</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -14,10 +14,18 @@
    <methodparam><type>string</type><parameter>string</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Gibt den ASCII-Wert des ersten Zeichens von <parameter>string</parameter>
-   zurück.
+   Interpretiert den ASCII-Wert des ersten Bytes von <parameter>string</parameter>
+   als vorzeichenlose Ganzzahl zwischen 0 und 255.
   </para>
   <para>
+   Liegt die Zeichenkette in einer Ein-Byte-Kodierung, wie ASCII, ISO-8859 oder
+   Windows 1252, vor, ist dies gleichwertig zur Rückgabe der Position des
+   Zeichens in der Zuordnungstabelle des Zeichensatzes. Allerdings ist zu
+   beachten, dass diese Funktion die Zeichenkettenkodierung ignoriert, und
+   insbesondere niemals einen Unicode Code-Point in einer Multi-Byte-Kodierung
+   wie UTF-8 oder UTF-16 erkennt.
+  </para>
+  <para>
    Die Funktion ist das Gegenstück zu <function>chr</function>.
   </para>
  </refsect1>
@@ -41,8 +49,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Gibt den ASCII-Wert als Integer zurück.
-   </para>
+   Ein Integer zwischen 0 und 255.
+  </para>
  </refsect1>

  <refsect1 role="examples">
@@ -62,6 +70,30 @@
     </programlisting>
    </example>
   </para>
+ <para>
+   <example>
+    <title>Untersuchen der einzelnen Bytes einer UTF-8-Zeichenkette</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+declare(encoding='UTF-8');
+$str = "🐘";
+for ( $pos=0; $pos < strlen($str); $pos ++ ) {
+ $byte = substr($str, $pos);
+ echo 'Byte ' . $pos . ' von $str hat den Wert ' . ord($byte) . PHP_EOL;
+}
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+Byte 0 von $str hat den Wert 240
+Byte 1 von $str hat den Wert 159
+Byte 2 von $str hat den Wert 144
+Byte 3 von $str hat den Wert 152
+    </screen>
+   </example>
+  </para>
  </refsect1>

  <refsect1 role="seealso">

Modified: phpdoc/de/trunk/reference/var/functions/is-string.xml
===================================================================
--- phpdoc/de/trunk/reference/var/functions/is-string.xml	2018-07-02 10:13:14 UTC (rev 345262)
+++ phpdoc/de/trunk/reference/var/functions/is-string.xml	2018-07-02 13:54:42 UTC (rev 345263)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 328337 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 345219 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.is-string" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>is_string</refname>