svn: /phpdoc/de/trunk/reference/misc/functions/ define.xml eval.xml get-browser.xml highlight-file.xml highlight-string.xml pack.xml sys-getloadavg.xml uniqid.xml unpack.xml

Modified: phpdoc/de/trunk/reference/misc/functions/define.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/define.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/define.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 336809 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.define" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -14,7 +14,7 @@
    <type>bool</type><methodname>define</methodname>
    <methodparam><type>string</type><parameter>name</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>case_insensitive</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>case_insensitive</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Definiert während der Laufzeit eine benannte Konstante.
@@ -37,14 +37,19 @@
      <term><parameter>value</parameter></term>
      <listitem>
       <para>
-       Der Wert der Konstante. Es sind nur Skalar- und <type>NULL</type>-Werte
-       erlaubt. Ab PHP 7 ist es ebenfalls möglich <type>array</type> Werte zu
-       verwenden. Skalarwerte sind <type>integer</type>,
-       <type>float</type>, <type>string</type> oder
-       <type>boolean</type> Werte. Es ist möglich, Konstanten vom Typ
-       <type>Ressource</type> zu definieren, allerdings wird dies nicht empfohlen,
-       da es unvorhersagbares Verhalten des Programms zur Folge haben kann.
+       Der Wert der Konstante.
+       In PHP 5 muss <parameter>value</parameter> ein <type>scalar</type>er Wert
+       (<type>integer</type>, <type>float</type>, <type>string</type>,
+       <type>boolean</type>, oder &null;) sein. In PHP 7 werden ebenfalls
+       <type>array</type> Werte akzeptiert.
       </para>
+      <warning>
+       <para>
+        Obgleich es möglich ist, Konstanten vom Typ
+        <type>Ressource</type> zu definieren, wird dies nicht empfohlen, da es
+        unvorhersagbares Verhalten des Programms zur Folge haben kann.
+       </para>
+      </warning>
      </listitem>
     </varlistentry>
     <varlistentry>

Modified: phpdoc/de/trunk/reference/misc/functions/eval.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/eval.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/eval.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 321375 Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 338282 Maintainer: hholzgra Status: ready -->
 <refentry xml:id="function.eval" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>eval</refname>
@@ -45,10 +45,10 @@
        Der Code darf nicht in öffnende und schließende
        <link linkend="language.basic-syntax.phpmode">PHP-Tags</link>
        eingeschlossen sein, d.h. <literal>'echo "Hi!";'</literal> muss anstelle
-       von <literal>'&lt;? echo "Hi!"; &gt;'</literal> übergeben werden.
+       von <literal>'&lt;?php echo "Hi!"; ?&gt;'</literal> übergeben werden.
        Es ist dennoch möglich den PHP-Modus durch die entsprechenden PHP-Tags zu
        verlassen und wieder zu betreten, z.B.
-       <literal>'echo "Im PHP-Modus!"; ?&gt;Im HTML-Modus!&lt;? echo "Wieder im PHP-Modus!";'</literal>.
+       <literal>'echo "Im PHP-Modus!"; ?&gt;Im HTML-Modus!&lt;?php echo "Wieder im PHP-Modus!";'</literal>.
       </para>
       <para>
        Abgesehen davon muss der übergebene Code gültiges PHP sein. Das
@@ -78,9 +78,11 @@
   <para>
    <function>eval</function> gibt &null; zurück, außer wenn im
    ausgewerteten Code <literal>return</literal> aufgerufen wird, dann aber
-   wird der an <literal>return</literal> übergebene Wert zurückgegeben. Falls
-   im ausgewerteten Code ein Parse Error auftritt, gibt
-   <function>eval</function> &false; zurück und der weitere Code wird normal
+   wird der an <literal>return</literal> übergebene Wert zurückgegeben.
+   Von PHP 7 an, wird <function>eval</function> im Falle eines Parse Errors im
+   ausgewerteten Code eine ParseError Exception werfen. Vor PHP 7 gab
+   <function>eval</function> in diesem Fall &false; zurück und der weitere Code
+   wurde normal
    ausgeführt. Es ist in <function>eval</function> nicht möglich, einen Parse
    Error mittels <function>set_error_handler</function> abzufangen.
   </para>

Modified: phpdoc/de/trunk/reference/misc/functions/get-browser.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/get-browser.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/get-browser.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 334605 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 3438 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.get-browser" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -13,7 +13,7 @@
   <methodsynopsis>
    <type>mixed</type><methodname>get_browser</methodname>
    <methodparam choice="opt"><type>string</type><parameter>user_agent</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>return_array</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>return_array</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Diese Funktion versucht die Fähigkeiten des Browsers des Benutzers zu

Modified: phpdoc/de/trunk/reference/misc/functions/highlight-file.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/highlight-file.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/highlight-file.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 334605 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.highlight-file" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>highlight_file</refname>
@@ -12,7 +12,7 @@
   <methodsynopsis>
    <type>mixed</type><methodname>highlight_file</methodname>
    <methodparam><type>string</type><parameter>filename</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Erzeugt die hervorgehobene Syntax des Codes der Datei

Modified: phpdoc/de/trunk/reference/misc/functions/highlight-string.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/highlight-string.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/highlight-string.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 334605 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.highlight-string" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -13,7 +13,7 @@
   <methodsynopsis>
    <type>mixed</type><methodname>highlight_string</methodname>
    <methodparam><type>string</type><parameter>str</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <simpara>
    Gibt HTML-Markup für die gehighlightete Syntaxversion des übergebenen PHP-Codes aus oder zurück.
@@ -67,22 +67,9 @@
 ?>
 ]]>
     </programlisting>
-    <para>
-     Das obige Beispiel gibt aus (in PHP 4):
-    </para>
+    &example.outputs;
     <screen>
 <![CDATA[
-<code><font color="#000000">
-<font color="#0000BB">&lt;?php phpinfo</font><font color="#007700">(); </font><font color="#0000BB">?&gt;</font>
-</font>
-</code>
-]]>
-    </screen>
-    <para>
-     Das obige Beispiel gibt aus (in PHP 5):
-    </para>
-    <screen>
-<![CDATA[
 <code><span style="color: #000000">
 <span style="color: #0000BB">&lt;?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?&gt;</span>
 </span>

Modified: phpdoc/de/trunk/reference/misc/functions/pack.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/pack.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/pack.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 335075 Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 343500 Maintainer: hholzgra Status: ready -->
 <refentry xml:id="function.pack" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>pack</refname>
@@ -184,10 +184,26 @@
            </entry>
           </row>
           <row>
+           <entry>g</entry>
+           <entry>Gleitkommazahl (maschinenabhängige Größe, Byte-Folge Little Endian)</entry>
+          </row>
+          <row>
+           <entry>G</entry>
+           <entry>Gleitkommazahl (maschinenabhängige Größe, Byte-Folge Big Endian)</entry>
+          </row>
+          <row>
            <entry>d</entry>
            <entry>Double-Typ (maschinenabhängige Größe und Wiedergabe)</entry>
           </row>
           <row>
+           <entry>e</entry>
+           <entry>Double-Typ (maschinenabhängige Größe, Byte-Folge Little Endian)</entry>
+          </row>
+          <row>
+           <entry>E</entry>
+           <entry>Double-Typ (maschinenabhängige Größe, Byte-Folge Big Endian)</entry>
+          </row>
+          <row>
            <entry>x</entry>
            <entry>NUL Byte</entry>
           </row>
@@ -240,6 +256,20 @@
      </thead>
      <tbody>
       <row>
+       <entry>7.2.0</entry>
+       <entry>
+        <type>float</type> und <type>double</type> Typen unterstützen sowohl Big
+        Endian als auch Little Endian.
+       </entry>
+      </row>
+      <row>
+       <entry>7.0.15, 7.1.1</entry>
+       <entry>
+        Die "e", "E", "g" and "G" Codes wurden hinzugefügt, um
+        Byte-Folgen-Unterstützung für float und double zu ermöglichen.
+       </entry>
+      </row>
+      <row>
        <entry>5.6.3</entry>
        <entry>
         Die "q", "Q", "J" und "P" Codes wurden hinzugefügt, um die Arbeit mit

Modified: phpdoc/de/trunk/reference/misc/functions/sys-getloadavg.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/sys-getloadavg.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/sys-getloadavg.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: hholzgra  Status: ready -->
+<!-- EN-Revision: 338915 Maintainer: hholzgra  Status: ready -->
 <refentry xml:id="function.sys-getloadavg" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>sys_getloadavg</refname>
@@ -36,7 +36,7 @@
 <![CDATA[
 <?php
 $load = sys_getloadavg();
-if ($load[0] > 80) {
+if ($load[0] > 0.80) {
     header('HTTP/1.1 503 Too busy, try again later');
     die('Serverlast zu hoch, versuchen Sie es später noch einmal.');
 }

Modified: phpdoc/de/trunk/reference/misc/functions/uniqid.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/uniqid.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/uniqid.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 334605 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.uniqid" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -13,20 +13,22 @@
   <methodsynopsis>
    <type>string</type><methodname>uniqid</methodname>
    <methodparam choice="opt"><type>string</type><parameter>prefix</parameter><initializer>""</initializer></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>more_entropy</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>more_entropy</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Gibt eine eindeutige ID mit Präfix zurück, die auf der aktuellen Zeit in
    Mikrosekunden basiert.
   </para>
+  &caution.cryptographically-insecure;
   <warning>
-   <para>
-    Diese Funktion erzeugt keine zufälligen oder unvoraussagbaren Zeichenketten.
-    <emphasis>Diese Funktion darf nicht für Sicherheitszwecke verwendet werden.</emphasis>
-    Kryptographisch sichere Zufalls-Funktionen/Generatoren und kryptographisch
-    sichere Hash-Funktionen sollten verwendet werden, um unvoraussagbare sichere
-    IDs zu erzeugen.
-   </para>
+    <para>
+     Diese Funktion garantiert nicht die Eindeutigkeit der Rückgabewerte. Da die
+     meisten System die Systemzeit durch NTP oder ähnlich justieren, ändert sich
+     die Systemzeit kontinuierlich. Daher ist es möglich, dass diese Funktion
+     keine eindeutige ID für den Prozess/Thread zurückgibt.
+     <parameter>more_entropy</parameter> kann verwendet werden, um die
+     Wahrscheinlichkeit der Eindeutigkeit zu erhöhen.
+    </para>
   </warning>
  </refsect1>

@@ -68,8 +70,14 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Gibt eine eindeutige ID als Zeichenkette zurück.
+   Gibt eine zeitstempelbasierte eindeutige ID als Zeichenkette zurück.
   </para>
+  <warning>
+   <para>
+    Diese Funktion versucht eine eindeutige Kennung zu erzeugen, aber sie
+    garantiert nicht die hunderprozentige Eindeutigkeit des Rückgabewerts.
+   </para>
+  </warning>
  </refsect1>

  <refsect1 role="examples">
@@ -102,15 +110,6 @@

  <refsect1 role="notes">
   &reftitle.notes;
-  <caution>
-   <para>
-    Diese Funktion erzeugt keine kryptographisch sicheren Tokens; tatsächlich
-    ist der Rückgabewert ohne die Übergabe eines zusätzlichen Parameters nur
-    wenig von <function>microtime</function> verschieden. Zum Erzeugen von
-    kryptographisch sicheren Tokens sollte
-    <function>openssl_random_pseudo_bytes</function> verwendet werden.
-   </para>
-  </caution>
   <note>
    <para>
     Unter Cygwin muss der Parameter <parameter>more_entropy</parameter> auf

Modified: phpdoc/de/trunk/reference/misc/functions/unpack.xml
===================================================================
--- phpdoc/de/trunk/reference/misc/functions/unpack.xml	2018-02-01 15:12:36 UTC (rev 344152)
+++ phpdoc/de/trunk/reference/misc/functions/unpack.xml	2018-02-01 16:16:11 UTC (rev 344153)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 329132 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 344003 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.unpack" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>unpack</refname>
@@ -13,6 +13,7 @@
    <type>array</type><methodname>unpack</methodname>
    <methodparam><type>string</type><parameter>format</parameter></methodparam>
    <methodparam><type>string</type><parameter>data</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
    Überträgt die Daten eines Binär-Strings in ein Array unter Berücksichtigung
@@ -46,6 +47,14 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>offset</parameter></term>
+     <listitem>
+      <para>
+       Der Offset, an dem das Entpacken beginnt.
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -71,6 +80,19 @@
      </thead>
      <tbody>
       <row>
+       <entry>7.2.0</entry>
+       <entry>
+        <type>float</type> und <type>double</type> Typen unterstützen sowohl Big
+        Endian als auch Little Endian.
+       </entry>
+      </row>
+      <row>
+       <entry>7.1.0</entry>
+       <entry>
+        Das optionale <parameter>offset</parameter> wurde hinzugefügt.
+       </entry>
+      </row>
+      <row>
        <entry>5.5.0</entry>
        <entry>
         <para>
@@ -106,13 +128,20 @@
 <?php
 $binarydata = "\x04\x00\xa0\x00";
 $array = unpack("cchars/nint", $binarydata);
+print_r($array);
 ?>
 ]]>
     </programlisting>
-    <para>
-     Das Ergebnis Array enthält die Einträge "chars" mit dem wert
-     <literal>4</literal> und "int" mit <literal>160</literal>.
-    </para>
+    &example.outputs;
+    <screen>
+<![CDATA[
+Array
+(
+    [chars] => 4
+    [int] => 160
+)
+]]>
+    </screen>
    </example>
   </para>

@@ -124,13 +153,21 @@
 <?php
 $binarydata = "\x04\x00\xa0\x00";
 $array = unpack("c2chars/nint", $binarydata);
+print_r($array);
 ?>
 ]]>
      </programlisting>
-     <para>
-      Das Ergebnis Array wird die Einträge "chars1", "chars2" and "int"
-      enthalten.
-     </para>
+     &example.outputs;
+     <screen>
+<![CDATA[
+Array
+(
+    [chars1] => 4
+    [chars2] => 0
+    [int] => 40960
+)
+]]>
+     </screen>
     </example>
    </para>
   </refsect1>
@@ -150,9 +187,10 @@
   </caution>
   <caution>
    <para>
-    Beachten Sie, dass für nicht benannte Elemente ein leerer String verwendet
-    wird. Werden mehrere Elemente nicht bennant, werden die entsprechenden
-    Elemente überschrieben, da die verwendeten Schlüssel identisch sind:
+    Wird ein Element nicht benannt, dann werden numerische Indizes beginnend mit
+    <literal>1</literal> verwendet. Es ist zu berücksichtigen, dass im Falle
+    mehrerer unbenannter Elemente ein Teil der Daten überschrieben wird, da die
+    Nummerierung für jedes Element wieder bei <literal>1</literal> beginnt.
    </para>
    <para>
     <example>
@@ -166,11 +204,21 @@
 ?>
 ]]>
      </programlisting>
+     &example.outputs;
+     <screen>
+<![CDATA[
+array(2) {
+  [1]=>
+  int(160)
+  [2]=>
+  int(66)
+}
+]]>
+     </screen>
      <para>
-      Das Ergebnis Array wird die Elemente "1" mit dem Wert <literal>160</literal>
-      und "2" mit <literal>66</literal> enthalten. Der erste Wert vom Symbol
-      <literal>c</literal> wurde mit dem Wert vom Symbol <literal>n</literal>
-      überschrieben.
+      Es ist zu beachten, dass der erste Wert vom Symbol
+      <literal>c</literal> mit dem Wert vom Symbol <literal>n</literal>
+      überschrieben wurde.
      </para>
     </example>
    </para>