cvs: phpdoc-de /reference/math constants.xml /reference/math/functions atan2.xml hexdec.xml max.xml min.xml mt-getrandmax.xml mt-rand.xml
mt-srand.xml
| From: | Carola 'Sammy' Kummert | Date: | Fri, 26 Oct 2007 14:56:10 +0000 |
| Subject: | cvs: phpdoc-de /reference/math constants.xml /reference/math/functions atan2.xml hexdec.xml max.xml min.xml mt-getrandmax.xml mt-rand.xml mt-srand.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2260@lists.php.net to get a copy of this message | ||
sammywg Fri Oct 26 14:56:10 2007 UTC
Modified files:
/phpdoc-de/reference/math constants.xml
/phpdoc-de/reference/math/functions atan2.xml hexdec.xml max.xml
min.xml mt-getrandmax.xml
mt-rand.xml mt-srand.xml
Log:
sync to en
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/constants.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-de/reference/math/constants.xml diff -u phpdoc-de/reference/math/constants.xml:1.1 phpdoc-de/reference/math/constants.xml:1.2 --- phpdoc-de/reference/math/constants.xml:1.1 Fri Oct 26 00:17:43 2007 +++ phpdoc-de/reference/math/constants.xml Fri Oct 26 14:56:10 2007 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.4 Maintainer: sammywg Status: ready --> <section xml:id="math.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants.core; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/atan2.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/math/functions/atan2.xml diff -u phpdoc-de/reference/math/functions/atan2.xml:1.8 phpdoc-de/reference/math/functions/atan2.xml:1.9 --- phpdoc-de/reference/math/functions/atan2.xml:1.8 Sat Jun 23 13:21:39 2007 +++ phpdoc-de/reference/math/functions/atan2.xml Fri Oct 26 14:56:10 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 --> -<!-- EN-Revision: 1.9 Maintainer: hholzgra Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: hholzgra Status: ready --> <refentry xml:id="function.atan2" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>atan2</refname> @@ -14,16 +14,16 @@ <methodparam><type>float</type><parameter>x</parameter></methodparam> </methodsynopsis> <simpara> - Diese Funktion berechnet den Arkustangens von + Diese Funktion berechnet den Arkustangens von <parameter>x</parameter>/<parameter>y</parameter>. Im Gegensatz zu <function>atan</function> kann sie dabei die Vorzeichen beider Parameter beachten und so den Quadranten des Ergebnisses bestimmen. </simpara> - <simpara> - Der Wertebereich vergrößert sich damit gegenüber + <simpara> + Der Wertebereich vergrößert sich damit gegenüber <function>atan</function> von <literal>(-Pi/2,i Pi/2]</literal> - auf <literal>(-Pi, Pi)</literal>. + auf <literal>(-Pi, Pi)</literal>. </simpara> </refsect1> <refsect1 role="parameters"> @@ -31,7 +31,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>x</parameter></term> + <term><parameter>y</parameter></term> <listitem> <para> Dividend @@ -39,7 +39,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>y</parameter></term> + <term><parameter>x</parameter></term> <listitem> <para> Divisor @@ -52,8 +52,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Der Arkustangens von <parameter>y</parameter>/<parameter>x</parameter> - in Bogenmaß + Der Arkustangens von <parameter>y</parameter>/<parameter>x</parameter> + in Bogenmaß </para> </refsect1> <refsect1 role="seealso"> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/hexdec.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/math/functions/hexdec.xml diff -u phpdoc-de/reference/math/functions/hexdec.xml:1.7 phpdoc-de/reference/math/functions/hexdec.xml:1.8 --- phpdoc-de/reference/math/functions/hexdec.xml:1.7 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/hexdec.xml Fri Oct 26 14:56:10 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 --> -<!-- EN-Revision: 1.13 Maintainer: hholzgra Status: ready --> +<!-- EN-Revision: 1.14 Maintainer: hholzgra Status: ready --> <refentry xml:id="function.hexdec" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>hexdec</refname> @@ -13,12 +13,12 @@ <methodparam><type>string</type><parameter>hex_string</parameter></methodparam> </methodsynopsis> <para> - Wandelt den hexadezimal kodierten Eingabestring + Wandelt den hexadezimal kodierten Eingabestring <parameter>hex_string</parameter> in einen Dezimalwert um. </para> <para> <function>hexdec</function> ignoriert alle nicht hexadezimal - kodierten Zeichen (0-9 a-f) in <parameter>hex_string</parameter>. + kodierten Zeichen (0-9 a-f) in <parameter>hex_string</parameter>. </para> </refsect1> <refsect1 role="parameters"> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/max.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/math/functions/max.xml diff -u phpdoc-de/reference/math/functions/max.xml:1.5 phpdoc-de/reference/math/functions/max.xml:1.6 --- phpdoc-de/reference/math/functions/max.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/max.xml Fri Oct 26 14:56:10 2007 @@ -1,42 +1,99 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.max" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>max</refname> - <refpurpose>Maximalwert bestimmen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>max</methodname> - <methodparam><type>mixed</type><parameter>arg1</parameter></methodparam> - <methodparam><type>mixed</type><parameter>arg2</parameter></methodparam> - <methodparam><type>mixed</type><parameter>argn</parameter></methodparam> - </methodsynopsis> - <para> - <function>max</function> liefert den numerisch größten - Eingabewert zurück. - </para> - <para> - Ist der erste Parameter ein Array, so wird der größte Wert - innerhalb dieses Array zurückgegeben. Anderenfalls müssen - mindestens zwei Parameter übergeben werden, und - <function>max</function> liefert den Wert des größten Parameters - zurück. Die Anzahl der Eingabe-Parameter ist nur durch den - verfügbaren Hauptspeicher begrenzt. - </para> - <para> - Ist mindestens einer der Eingabewerte vom Typ double, so werden - alle Werte als double behandelt und der Rückgabewert ist - ebenfalls vom Typ double. Anderenfalls werden alle Eingabewerte - als int behandelt und auch ein int zurückgegeben. - </para> - <para> - Siehe auch <function>min</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.2 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.max"> + <refnamediv> + <refname>max</refname> + <refpurpose>Maximalwert bestimmen</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>max</methodname> + <methodparam><type>array</type><parameter>values</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>max</methodname> + <methodparam><type>mixed</type><parameter>value1</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value2</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>value3...</parameter></methodparam> + </methodsynopsis> + <para> + Ist der erste und einzige Parameter ist ein Array, gibt <function>max</function> + den höchsten Wert dieses Arrays zurück. Sind mindestens zwei Parameter übergeben, + gibt <function>max</function> den größeren dieser Werte zurück. + </para> + <note> + <para> + PHP evaluiert nicht-numerische <type>string</type>-Daten zu <literal>0</literal>, + wenn sie mit einem <type>integer</type>-Wert verglichen werden, gibt aber + trotzdem die Zeichenkette zurück, wenn sie den numerisch höheren Wert hat. + Werden mehrere Argumente zu <literal>0</literal> evaluiert, gibt + <function>max</function> den numerischen Wert <literal>0</literal>, sofern + er übergeben wurde, andernfalls den alphabetisch höchstwertigen String. + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>values</parameter></term> + <listitem> + <para> + Ein die Werte enthaltendes Array. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>max</function> liefert den numerisch größten Parameterwert zurück. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Verwendungsbeispiel von <function>max</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +echo max(1, 3, 5, 6, 7); // 7 +echo max(array(2, 4, 5)); // 5 + +echo max(0, 'hello'); // 0 +echo max('hello', 0); // hello +echo max(-1, 'hello'); // hello + +// Bei multiplen Arrays vergleicht max von links nach rechts, +// daher ist in unserem Beispiel 2 == 2, aber 4 < 5 +$val = max(array(2, 4, 8), array(2, 5, 7)); // array(2, 5, 7) + +// Sind ein Array und ein Nicht-Array-Parameter gegeben, wird immer +// das Array als größerer Wert angesehen +$val = max('string', array(2, 5, 7), 42); // array(2, 5, 7) +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>min</function></member> + <member><function>count</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/min.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/math/functions/min.xml diff -u phpdoc-de/reference/math/functions/min.xml:1.5 phpdoc-de/reference/math/functions/min.xml:1.6 --- phpdoc-de/reference/math/functions/min.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/min.xml Fri Oct 26 14:56:10 2007 @@ -1,42 +1,100 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.min" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>min</refname> - <refpurpose>Minimalwert bestimmen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>min</methodname> - <methodparam><type>mixed</type><parameter>arg1</parameter></methodparam> - <methodparam><type>mixed</type><parameter>arg2</parameter></methodparam> - <methodparam><type>mixed</type><parameter>argn</parameter></methodparam> - </methodsynopsis> - <para> - <function>min</function> liefert den numerisch kleinsten - Eingabewert zurück. - </para> - <para> - Ist der erste Parameter ein Array, so wird der kleinste Wert - innerhalb dieses Array zurückgegeben. Anderenfalls müssen - mindestens zwei Parameter übergeben werden, und - <function>min</function> liefert den Wert des kleinsten - Parameters zurück. Die Anzahl der Eingabe-Parameter ist nur durch - den verfügbaren Hauptspeicher begrenzt. - </para> - <para> - Ist mindestens einer der Eingabewerte vom Typ double, so werden - alle Werte als double behandelt und der Rückgabewert ist - ebenfalls vom Typ double. Anderenfalls werden alle Eingabewerte - als int behandelt und auch ein int zurückgegeben. - </para> - <para> - Siehe auch <function>max</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.min"> + <refnamediv> + <refname>min</refname> + <refpurpose>Minimalwert bestimmen</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>min</methodname> + <methodparam><type>array</type><parameter>values</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>min</methodname> + <methodparam><type>mixed</type><parameter>value1</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value2</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>value3...</parameter></methodparam> + </methodsynopsis> + <para> + Ist der erste und einzige Parameter ist ein Array, gibt <function>min</function> + den niedrigsten Wert dieses Arrays zurück. Sind mindestens zwei Parameter übergeben, + gibt <function>min</function> den kleinsten dieser Werte zurück. + </para> + <note> + <para> + PHP evaluiert nicht-numerische <type>string</type>-Daten zu <literal>0</literal>, + wenn sie mit einem <type>integer</type>-Wert verglichen werden, gibt aber + trotzdem die Zeichenkette zurück, wenn sie den numerisch niedrigsten Wert hat. + Werden mehrere Argumente zu <literal>0</literal> evaluiert, gibt + <function>min</function> den niedrigstwertigen alphanumerischen String zurück, + wenn mehrere Zeichenketten übergeben wurden, andernfalls den numerischen + Wert <literal>0</literal>. + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>values</parameter></term> + <listitem> + <para> + Ein die Werte enthaltendes Array. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>min</function> liefert den numerisch kleinsten Parameterwert zurück. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Verwendungsbeispiel von <function>min</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +echo min(2, 3, 1, 6, 7); // 1 +echo min(array(2, 4, 5)); // 2 + +echo min(0, 'hello'); // 0 +echo min('hello', 0); // hello +echo min('hello', -1); // -1 + +// Bei multiplen Arrays vergleicht min von links nach rechts, +// daher ist in unserem Beispiel 2 == 2, aber 4 < 5 +$val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8) + +// Sind ein Array und ein Nicht-Array-Parameter gegeben, wird +// das Array niemals zurückgegeben, da es als größer betrachtet wird +$val = min('string', array(2, 5, 7), 42); // string +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>max</function></member> + <member><function>count</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/mt-getrandmax.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/math/functions/mt-getrandmax.xml diff -u phpdoc-de/reference/math/functions/mt-getrandmax.xml:1.5 phpdoc-de/reference/math/functions/mt-getrandmax.xml:1.6 --- phpdoc-de/reference/math/functions/mt-getrandmax.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/mt-getrandmax.xml Fri Oct 26 14:56:10 2007 @@ -1,29 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.mt-getrandmax" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>mt_getrandmax</refname> - <refpurpose>show largest possible random value</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>mt_getrandmax</methodname> - <void/> - </methodsynopsis> - <para> - Diese Funktion liefert den höchsten Wert, den ein Aufruf der - Funktion <function>mt_rand</function> auf dieser Plattform - zurückgeben kann. - </para> - <para> - Siehe auch <function>mt_rand</function>, - <function>mt_srand</function> <function>rand</function>, - <function>srand</function> and <function>getrandmax</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> +<refentry xml:id="function.mt-getrandmax" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>mt_getrandmax</refname> + <refpurpose>Zeigt den größtmöglichen Zufallswert an</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>mt_getrandmax</methodname> + <void/> + </methodsynopsis> + <simpara> + Gibt den größtmöglichen Wert eines Aufrufs von <function>mt_rand</function> + zurück. + </simpara> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den größtmöglichen Zufallswert zurück, den ein Aufruf von <function>mt_rand</function> + erzeugen kann. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mt_rand</function></member> + <member><function>mt_srand</function></member> + <member><function>getrandmax</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/mt-rand.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/math/functions/mt-rand.xml diff -u phpdoc-de/reference/math/functions/mt-rand.xml:1.9 phpdoc-de/reference/math/functions/mt-rand.xml:1.10 --- phpdoc-de/reference/math/functions/mt-rand.xml:1.9 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/mt-rand.xml Fri Oct 26 14:56:10 2007 @@ -1,74 +1,134 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>mt_rand</refname> - <refpurpose>Erzeugt 'bessere' Zufallszahlen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>mt_rand</methodname> - <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> - <methodparam><type>int</type><parameter>max</parameter></methodparam> - </methodsynopsis> - <para> - Die PHP <function>rand</function> Funktion benutzt den in der - jeweiligen libc enthaltenen Zufallsgenerator. Gerade in älteren - libc-Versionen ist dieser aber oft langsam und die Qualität der - erzeugten Pseudozufalls-Sequenzen ist unbefriedigend bis - unbekannt. - </para> - <para> - Die Funktion <function>mt_rand</function> bietet einen Drop-In - Ersatz für die von der libc bereitgestellten Funktionen. Sie - benutzt einen Zufallsgenerator mit bekannter Charakteristik, den - sogenannten "Mersenne Twister", der Pseudozufalls-Sequenzen - generiert, die auch kryptografischen Ansprüchen genügen sollten - und viermal so schnell arbeitet wie der typische - libc-Algorithmus. - </para> - <para> - Weitere Informationen zum Mersenne Twister und zur optimierten - Implementation finden sich unter <link - xlink:href="&url.mersenne;">&url.mersenne;</link>. - </para> - <para> - Ohne die optionalen Parameter <parameter>min</parameter> und - <parameter>max</parameter> liefert <function>mt_rand</function> - eine Pseudo-Zufallszahl zwischen 0 und einem plattformabhängigen - Maximalwert, der mit <function>mt_getrandmax</function> ermittelt - werden kann. - </para> - <para> - Benutzen Sie unbedingt <function>mt_srand</function>, um vor dem - ersten Aufruf von <function>mt_rand</function> einen neuen - Startwert festzulegen, ansonsten erhalten Sie bei jedem - Programmlauf dieselbe Sequenz von Werten. - </para> - <note> - <para> - Seit PHP 4.2.0 ist es nicht mehr nötig, den Zufallszahlengenerator zu - initialisieren, bevor man ihn benutzt. - </para> - </note> - <note> - <para> - In PHP-Versionen vor 3.0.7 hatte der zweite Parameter - <parameter>max</parameter> nicht den Maximalwert sondern die - Größe des Werteintervalls an, d.h. in diesen älteren Version muss - statt <literal>mt_rand(min,max) mt_rand(min,max-min)</literal> - benutzt werden, um dasselbe Ergebnis zu erhalten. - </para> - </note> - <para> - Siehe auch <function>mt_srand</function>, - <function>mt_getrandmax</function>, <function>srand</function>, - <function>rand</function> und <function>getrandmax</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.15 Maintainer: sammywg Status: ready --> +<refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>mt_rand</refname> + <refpurpose>Erzeugt 'bessere' Zufallszahlen</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>mt_rand</methodname> + <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> + <methodparam><type>int</type><parameter>max</parameter></methodparam> + </methodsynopsis> + <simpara> + Viele Zufallszahlengeneratoren, die auf älteren libc-Versionen basieren, haben + seltsame oder doch zumindest unerwartete Verhaltensweisen und sind zudem recht + langsam. Standardmäßig verwendet PHP den libc-Zufallszahlengenerator mit der + Funktion <function>rand</function>. Die Funktion <function>mt_rand</function> + kann jedoch als vollwertiger Ersatz verwendet werden. Sie verwendet einen + Zufallszahlengenerator mit den bekannten Charakteristika der + <link xlink:href="&url.mersenne;">Mersenne Twister</link>, die Zufallszahlen + viermal schneller generiert als der durchschnittliche libc-rand()-Aufruf. + </simpara> + <simpara> + Wenn die Funktion ohne Angabe von <parameter>min</parameter> und/oder + <parameter>max</parameter> aufgerufen, gibt <function>mt_rand</function> + eine Pseudozufallszahl zwischen 0 und <constant>RAND_MAX</constant> zurück. + Benötigen Sie zum Beispiel eine Zufallszahl zwischen 5 und 15 (inklusive), + verwenden Sie <literal>mt_rand(5, 15)</literal>. + </simpara> + ¬e.randomseed; + + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>min</parameter></term> + <listitem> + <para> + Der optionale niedrigste Wert, der zurückgegeben werden kann (Standardwert: 0). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>max</parameter></term> + <listitem> + <para> + Der optionale höchste Wert, der zurückgegeben werden kann (Standardwert: RAND_MAX). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ein zufälliger Integerwert zwischen <parameter>min</parameter> (oder 0) und + <parameter>max</parameter> (oder RAND_MAX, inklusive). + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 3.0.7</entry> + <entry> + In PHP-Versionen vor 3.0.7 gab der zweite Parameter + <parameter>max</parameter> nicht den Maximalwert sondern die + Größe des Werteintervalls (<parameter>range</parameter> an. + Um in diesen älteren Versionen das selbe Ergebnis zu erhalten, + sollten Sie in dem kurzen Beispiel <literal>rand (5,11)</literal> + verwenden, um eine Zufallszahl zwischen 5 und 15 zu erzeugen. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>mt_rand</function>-Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo mt_rand() . "\n"; +echo mt_rand() . "\n"; + +echo mt_rand(5, 15); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +1604716014 +1478613278 +6 +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mt_srand</function></member> + <member><function>mt_getrandmax</function></member> + <member><function>rand</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/mt-srand.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/math/functions/mt-srand.xml diff -u phpdoc-de/reference/math/functions/mt-srand.xml:1.6 phpdoc-de/reference/math/functions/mt-srand.xml:1.7 --- phpdoc-de/reference/math/functions/mt-srand.xml:1.6 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/mt-srand.xml Fri Oct 26 14:56:10 2007 @@ -1,43 +1,107 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.mt-srand" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>mt_srand</refname> - <refpurpose>seed the better random number generator</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>mt_srand</methodname> - <methodparam><type>int</type><parameter>seed</parameter></methodparam> - </methodsynopsis> - <para> - Legt einen internen Startwert für den Zufallsgenerator in - <function>mt_rand</function> fest. Gleiche Startwerte führen - auch jeweils zu derselben Pseudo-Zufallssequenzen daher ist es - üblich, diese über die aktuelle Uhrzeit festzulegen: - <informalexample> - <programlisting role="php"> -// seed with microseconds since last "whole" second -mt_srand((double)microtime()*1000000); +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mt-srand"> + <refnamediv> + <refname>mt_srand</refname> + <refpurpose>Setzt den besseren Zufallszahlengenerator</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>mt_srand</methodname> + <methodparam choice="opt"><type>int</type><parameter>seed</parameter></methodparam> + </methodsynopsis> + <para> + Setzt den Zufallszahlengenerator mit <parameter>seed</parameter> oder mit + einem Zufallswert, wenn <parameter>seed</parameter> nicht angegeben ist. + </para> + ¬e.randomseed; + + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>seed</parameter></term> + <listitem> + <para> + Ein optionaler seed-Wert. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.2.0</entry> + <entry> + Der Parameter <parameter>seed</parameter> wird optional und enthält + standardmäßig einen Zufallswert, sofern er nicht angegeben wurde. + </entry> + </row> + <row> + <entry>Since 5.2.1</entry> + <entry> + Die Mersenne-Twister-Implementation in PHP verwendet jetzt einen + neuen Seeding-Algorithmus von Richard Wagner. Identische Seeds erzeugen + nicht länger die selbe Sequenz von Werten wie in früheren Versionen. + Dieses Verhalten wird nicht als noch einmal wechselnd erwartet, aber es + ist trotzdem nicht sicher, darauf bedingungslos zu vertrauen. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>mt_srand</function>-Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +// seed mit Mikrosekunden +function make_seed() +{ + list($usec, $sec) = explode(' ', microtime()); + return (float) $sec + ((float) $usec * 100000); +} +mt_srand(make_seed()); $randval = mt_rand(); - </programlisting> - </informalexample> - </para> - <note> - <para> - Seit PHP 4.2.0 ist es nicht mehr nötig, den Zufallszahlengenerator zu - initialisieren, bevor man ihn benutzt. - </para> - </note> - <para> - Siehe auch <function>mt_rand</function>, - <function>mt_getrandmax</function>, <function>srand</function>, - <function>rand</function> und <function>getrandmax</function>. - </para> - </refsect1> - </refentry> +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mt_rand</function></member> + <member><function>mt_getrandmax</function></member> + <member><function>srand</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/constants.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-de/reference/math/constants.xml diff -u phpdoc-de/reference/math/constants.xml:1.1 phpdoc-de/reference/math/constants.xml:1.2 --- phpdoc-de/reference/math/constants.xml:1.1 Fri Oct 26 00:17:43 2007 +++ phpdoc-de/reference/math/constants.xml Fri Oct 26 14:56:10 2007 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.4 Maintainer: sammywg Status: ready --> <section xml:id="math.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants.core; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/atan2.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/math/functions/atan2.xml diff -u phpdoc-de/reference/math/functions/atan2.xml:1.8 phpdoc-de/reference/math/functions/atan2.xml:1.9 --- phpdoc-de/reference/math/functions/atan2.xml:1.8 Sat Jun 23 13:21:39 2007 +++ phpdoc-de/reference/math/functions/atan2.xml Fri Oct 26 14:56:10 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 --> -<!-- EN-Revision: 1.9 Maintainer: hholzgra Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: hholzgra Status: ready --> <refentry xml:id="function.atan2" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>atan2</refname> @@ -14,16 +14,16 @@ <methodparam><type>float</type><parameter>x</parameter></methodparam> </methodsynopsis> <simpara> - Diese Funktion berechnet den Arkustangens von + Diese Funktion berechnet den Arkustangens von <parameter>x</parameter>/<parameter>y</parameter>. Im Gegensatz zu <function>atan</function> kann sie dabei die Vorzeichen beider Parameter beachten und so den Quadranten des Ergebnisses bestimmen. </simpara> - <simpara> - Der Wertebereich vergrößert sich damit gegenüber + <simpara> + Der Wertebereich vergrößert sich damit gegenüber <function>atan</function> von <literal>(-Pi/2,i Pi/2]</literal> - auf <literal>(-Pi, Pi)</literal>. + auf <literal>(-Pi, Pi)</literal>. </simpara> </refsect1> <refsect1 role="parameters"> @@ -31,7 +31,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>x</parameter></term> + <term><parameter>y</parameter></term> <listitem> <para> Dividend @@ -39,7 +39,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>y</parameter></term> + <term><parameter>x</parameter></term> <listitem> <para> Divisor @@ -52,8 +52,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Der Arkustangens von <parameter>y</parameter>/<parameter>x</parameter> - in Bogenmaß + Der Arkustangens von <parameter>y</parameter>/<parameter>x</parameter> + in Bogenmaß </para> </refsect1> <refsect1 role="seealso"> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/hexdec.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/math/functions/hexdec.xml diff -u phpdoc-de/reference/math/functions/hexdec.xml:1.7 phpdoc-de/reference/math/functions/hexdec.xml:1.8 --- phpdoc-de/reference/math/functions/hexdec.xml:1.7 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/hexdec.xml Fri Oct 26 14:56:10 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 --> -<!-- EN-Revision: 1.13 Maintainer: hholzgra Status: ready --> +<!-- EN-Revision: 1.14 Maintainer: hholzgra Status: ready --> <refentry xml:id="function.hexdec" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>hexdec</refname> @@ -13,12 +13,12 @@ <methodparam><type>string</type><parameter>hex_string</parameter></methodparam> </methodsynopsis> <para> - Wandelt den hexadezimal kodierten Eingabestring + Wandelt den hexadezimal kodierten Eingabestring <parameter>hex_string</parameter> in einen Dezimalwert um. </para> <para> <function>hexdec</function> ignoriert alle nicht hexadezimal - kodierten Zeichen (0-9 a-f) in <parameter>hex_string</parameter>. + kodierten Zeichen (0-9 a-f) in <parameter>hex_string</parameter>. </para> </refsect1> <refsect1 role="parameters"> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/max.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/math/functions/max.xml diff -u phpdoc-de/reference/math/functions/max.xml:1.5 phpdoc-de/reference/math/functions/max.xml:1.6 --- phpdoc-de/reference/math/functions/max.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/max.xml Fri Oct 26 14:56:10 2007 @@ -1,42 +1,99 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.max" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>max</refname> - <refpurpose>Maximalwert bestimmen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>max</methodname> - <methodparam><type>mixed</type><parameter>arg1</parameter></methodparam> - <methodparam><type>mixed</type><parameter>arg2</parameter></methodparam> - <methodparam><type>mixed</type><parameter>argn</parameter></methodparam> - </methodsynopsis> - <para> - <function>max</function> liefert den numerisch größten - Eingabewert zurück. - </para> - <para> - Ist der erste Parameter ein Array, so wird der größte Wert - innerhalb dieses Array zurückgegeben. Anderenfalls müssen - mindestens zwei Parameter übergeben werden, und - <function>max</function> liefert den Wert des größten Parameters - zurück. Die Anzahl der Eingabe-Parameter ist nur durch den - verfügbaren Hauptspeicher begrenzt. - </para> - <para> - Ist mindestens einer der Eingabewerte vom Typ double, so werden - alle Werte als double behandelt und der Rückgabewert ist - ebenfalls vom Typ double. Anderenfalls werden alle Eingabewerte - als int behandelt und auch ein int zurückgegeben. - </para> - <para> - Siehe auch <function>min</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.2 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.max"> + <refnamediv> + <refname>max</refname> + <refpurpose>Maximalwert bestimmen</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>max</methodname> + <methodparam><type>array</type><parameter>values</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>max</methodname> + <methodparam><type>mixed</type><parameter>value1</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value2</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>value3...</parameter></methodparam> + </methodsynopsis> + <para> + Ist der erste und einzige Parameter ist ein Array, gibt <function>max</function> + den höchsten Wert dieses Arrays zurück. Sind mindestens zwei Parameter übergeben, + gibt <function>max</function> den größeren dieser Werte zurück. + </para> + <note> + <para> + PHP evaluiert nicht-numerische <type>string</type>-Daten zu <literal>0</literal>, + wenn sie mit einem <type>integer</type>-Wert verglichen werden, gibt aber + trotzdem die Zeichenkette zurück, wenn sie den numerisch höheren Wert hat. + Werden mehrere Argumente zu <literal>0</literal> evaluiert, gibt + <function>max</function> den numerischen Wert <literal>0</literal>, sofern + er übergeben wurde, andernfalls den alphabetisch höchstwertigen String. + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>values</parameter></term> + <listitem> + <para> + Ein die Werte enthaltendes Array. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>max</function> liefert den numerisch größten Parameterwert zurück. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Verwendungsbeispiel von <function>max</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +echo max(1, 3, 5, 6, 7); // 7 +echo max(array(2, 4, 5)); // 5 + +echo max(0, 'hello'); // 0 +echo max('hello', 0); // hello +echo max(-1, 'hello'); // hello + +// Bei multiplen Arrays vergleicht max von links nach rechts, +// daher ist in unserem Beispiel 2 == 2, aber 4 < 5 +$val = max(array(2, 4, 8), array(2, 5, 7)); // array(2, 5, 7) + +// Sind ein Array und ein Nicht-Array-Parameter gegeben, wird immer +// das Array als größerer Wert angesehen +$val = max('string', array(2, 5, 7), 42); // array(2, 5, 7) +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>min</function></member> + <member><function>count</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/min.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/math/functions/min.xml diff -u phpdoc-de/reference/math/functions/min.xml:1.5 phpdoc-de/reference/math/functions/min.xml:1.6 --- phpdoc-de/reference/math/functions/min.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/min.xml Fri Oct 26 14:56:10 2007 @@ -1,42 +1,100 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.min" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>min</refname> - <refpurpose>Minimalwert bestimmen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>min</methodname> - <methodparam><type>mixed</type><parameter>arg1</parameter></methodparam> - <methodparam><type>mixed</type><parameter>arg2</parameter></methodparam> - <methodparam><type>mixed</type><parameter>argn</parameter></methodparam> - </methodsynopsis> - <para> - <function>min</function> liefert den numerisch kleinsten - Eingabewert zurück. - </para> - <para> - Ist der erste Parameter ein Array, so wird der kleinste Wert - innerhalb dieses Array zurückgegeben. Anderenfalls müssen - mindestens zwei Parameter übergeben werden, und - <function>min</function> liefert den Wert des kleinsten - Parameters zurück. Die Anzahl der Eingabe-Parameter ist nur durch - den verfügbaren Hauptspeicher begrenzt. - </para> - <para> - Ist mindestens einer der Eingabewerte vom Typ double, so werden - alle Werte als double behandelt und der Rückgabewert ist - ebenfalls vom Typ double. Anderenfalls werden alle Eingabewerte - als int behandelt und auch ein int zurückgegeben. - </para> - <para> - Siehe auch <function>max</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.min"> + <refnamediv> + <refname>min</refname> + <refpurpose>Minimalwert bestimmen</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>min</methodname> + <methodparam><type>array</type><parameter>values</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>min</methodname> + <methodparam><type>mixed</type><parameter>value1</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value2</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>value3...</parameter></methodparam> + </methodsynopsis> + <para> + Ist der erste und einzige Parameter ist ein Array, gibt <function>min</function> + den niedrigsten Wert dieses Arrays zurück. Sind mindestens zwei Parameter übergeben, + gibt <function>min</function> den kleinsten dieser Werte zurück. + </para> + <note> + <para> + PHP evaluiert nicht-numerische <type>string</type>-Daten zu <literal>0</literal>, + wenn sie mit einem <type>integer</type>-Wert verglichen werden, gibt aber + trotzdem die Zeichenkette zurück, wenn sie den numerisch niedrigsten Wert hat. + Werden mehrere Argumente zu <literal>0</literal> evaluiert, gibt + <function>min</function> den niedrigstwertigen alphanumerischen String zurück, + wenn mehrere Zeichenketten übergeben wurden, andernfalls den numerischen + Wert <literal>0</literal>. + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>values</parameter></term> + <listitem> + <para> + Ein die Werte enthaltendes Array. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>min</function> liefert den numerisch kleinsten Parameterwert zurück. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Verwendungsbeispiel von <function>min</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +echo min(2, 3, 1, 6, 7); // 1 +echo min(array(2, 4, 5)); // 2 + +echo min(0, 'hello'); // 0 +echo min('hello', 0); // hello +echo min('hello', -1); // -1 + +// Bei multiplen Arrays vergleicht min von links nach rechts, +// daher ist in unserem Beispiel 2 == 2, aber 4 < 5 +$val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8) + +// Sind ein Array und ein Nicht-Array-Parameter gegeben, wird +// das Array niemals zurückgegeben, da es als größer betrachtet wird +$val = min('string', array(2, 5, 7), 42); // string +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>max</function></member> + <member><function>count</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/mt-getrandmax.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/math/functions/mt-getrandmax.xml diff -u phpdoc-de/reference/math/functions/mt-getrandmax.xml:1.5 phpdoc-de/reference/math/functions/mt-getrandmax.xml:1.6 --- phpdoc-de/reference/math/functions/mt-getrandmax.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/mt-getrandmax.xml Fri Oct 26 14:56:10 2007 @@ -1,29 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.mt-getrandmax" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>mt_getrandmax</refname> - <refpurpose>show largest possible random value</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>mt_getrandmax</methodname> - <void/> - </methodsynopsis> - <para> - Diese Funktion liefert den höchsten Wert, den ein Aufruf der - Funktion <function>mt_rand</function> auf dieser Plattform - zurückgeben kann. - </para> - <para> - Siehe auch <function>mt_rand</function>, - <function>mt_srand</function> <function>rand</function>, - <function>srand</function> and <function>getrandmax</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> +<refentry xml:id="function.mt-getrandmax" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>mt_getrandmax</refname> + <refpurpose>Zeigt den größtmöglichen Zufallswert an</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>mt_getrandmax</methodname> + <void/> + </methodsynopsis> + <simpara> + Gibt den größtmöglichen Wert eines Aufrufs von <function>mt_rand</function> + zurück. + </simpara> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den größtmöglichen Zufallswert zurück, den ein Aufruf von <function>mt_rand</function> + erzeugen kann. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mt_rand</function></member> + <member><function>mt_srand</function></member> + <member><function>getrandmax</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/mt-rand.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/math/functions/mt-rand.xml diff -u phpdoc-de/reference/math/functions/mt-rand.xml:1.9 phpdoc-de/reference/math/functions/mt-rand.xml:1.10 --- phpdoc-de/reference/math/functions/mt-rand.xml:1.9 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/mt-rand.xml Fri Oct 26 14:56:10 2007 @@ -1,74 +1,134 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>mt_rand</refname> - <refpurpose>Erzeugt 'bessere' Zufallszahlen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>mt_rand</methodname> - <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> - <methodparam><type>int</type><parameter>max</parameter></methodparam> - </methodsynopsis> - <para> - Die PHP <function>rand</function> Funktion benutzt den in der - jeweiligen libc enthaltenen Zufallsgenerator. Gerade in älteren - libc-Versionen ist dieser aber oft langsam und die Qualität der - erzeugten Pseudozufalls-Sequenzen ist unbefriedigend bis - unbekannt. - </para> - <para> - Die Funktion <function>mt_rand</function> bietet einen Drop-In - Ersatz für die von der libc bereitgestellten Funktionen. Sie - benutzt einen Zufallsgenerator mit bekannter Charakteristik, den - sogenannten "Mersenne Twister", der Pseudozufalls-Sequenzen - generiert, die auch kryptografischen Ansprüchen genügen sollten - und viermal so schnell arbeitet wie der typische - libc-Algorithmus. - </para> - <para> - Weitere Informationen zum Mersenne Twister und zur optimierten - Implementation finden sich unter <link - xlink:href="&url.mersenne;">&url.mersenne;</link>. - </para> - <para> - Ohne die optionalen Parameter <parameter>min</parameter> und - <parameter>max</parameter> liefert <function>mt_rand</function> - eine Pseudo-Zufallszahl zwischen 0 und einem plattformabhängigen - Maximalwert, der mit <function>mt_getrandmax</function> ermittelt - werden kann. - </para> - <para> - Benutzen Sie unbedingt <function>mt_srand</function>, um vor dem - ersten Aufruf von <function>mt_rand</function> einen neuen - Startwert festzulegen, ansonsten erhalten Sie bei jedem - Programmlauf dieselbe Sequenz von Werten. - </para> - <note> - <para> - Seit PHP 4.2.0 ist es nicht mehr nötig, den Zufallszahlengenerator zu - initialisieren, bevor man ihn benutzt. - </para> - </note> - <note> - <para> - In PHP-Versionen vor 3.0.7 hatte der zweite Parameter - <parameter>max</parameter> nicht den Maximalwert sondern die - Größe des Werteintervalls an, d.h. in diesen älteren Version muss - statt <literal>mt_rand(min,max) mt_rand(min,max-min)</literal> - benutzt werden, um dasselbe Ergebnis zu erhalten. - </para> - </note> - <para> - Siehe auch <function>mt_srand</function>, - <function>mt_getrandmax</function>, <function>srand</function>, - <function>rand</function> und <function>getrandmax</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.15 Maintainer: sammywg Status: ready --> +<refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>mt_rand</refname> + <refpurpose>Erzeugt 'bessere' Zufallszahlen</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>mt_rand</methodname> + <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> + <methodparam><type>int</type><parameter>max</parameter></methodparam> + </methodsynopsis> + <simpara> + Viele Zufallszahlengeneratoren, die auf älteren libc-Versionen basieren, haben + seltsame oder doch zumindest unerwartete Verhaltensweisen und sind zudem recht + langsam. Standardmäßig verwendet PHP den libc-Zufallszahlengenerator mit der + Funktion <function>rand</function>. Die Funktion <function>mt_rand</function> + kann jedoch als vollwertiger Ersatz verwendet werden. Sie verwendet einen + Zufallszahlengenerator mit den bekannten Charakteristika der + <link xlink:href="&url.mersenne;">Mersenne Twister</link>, die Zufallszahlen + viermal schneller generiert als der durchschnittliche libc-rand()-Aufruf. + </simpara> + <simpara> + Wenn die Funktion ohne Angabe von <parameter>min</parameter> und/oder + <parameter>max</parameter> aufgerufen, gibt <function>mt_rand</function> + eine Pseudozufallszahl zwischen 0 und <constant>RAND_MAX</constant> zurück. + Benötigen Sie zum Beispiel eine Zufallszahl zwischen 5 und 15 (inklusive), + verwenden Sie <literal>mt_rand(5, 15)</literal>. + </simpara> + ¬e.randomseed; + + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>min</parameter></term> + <listitem> + <para> + Der optionale niedrigste Wert, der zurückgegeben werden kann (Standardwert: 0). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>max</parameter></term> + <listitem> + <para> + Der optionale höchste Wert, der zurückgegeben werden kann (Standardwert: RAND_MAX). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ein zufälliger Integerwert zwischen <parameter>min</parameter> (oder 0) und + <parameter>max</parameter> (oder RAND_MAX, inklusive). + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 3.0.7</entry> + <entry> + In PHP-Versionen vor 3.0.7 gab der zweite Parameter + <parameter>max</parameter> nicht den Maximalwert sondern die + Größe des Werteintervalls (<parameter>range</parameter> an. + Um in diesen älteren Versionen das selbe Ergebnis zu erhalten, + sollten Sie in dem kurzen Beispiel <literal>rand (5,11)</literal> + verwenden, um eine Zufallszahl zwischen 5 und 15 zu erzeugen. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>mt_rand</function>-Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo mt_rand() . "\n"; +echo mt_rand() . "\n"; + +echo mt_rand(5, 15); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +1604716014 +1478613278 +6 +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mt_srand</function></member> + <member><function>mt_getrandmax</function></member> + <member><function>rand</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/math/functions/mt-srand.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/math/functions/mt-srand.xml diff -u phpdoc-de/reference/math/functions/mt-srand.xml:1.6 phpdoc-de/reference/math/functions/mt-srand.xml:1.7 --- phpdoc-de/reference/math/functions/mt-srand.xml:1.6 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/math/functions/mt-srand.xml Fri Oct 26 14:56:10 2007 @@ -1,43 +1,107 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.mt-srand" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>mt_srand</refname> - <refpurpose>seed the better random number generator</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>mt_srand</methodname> - <methodparam><type>int</type><parameter>seed</parameter></methodparam> - </methodsynopsis> - <para> - Legt einen internen Startwert für den Zufallsgenerator in - <function>mt_rand</function> fest. Gleiche Startwerte führen - auch jeweils zu derselben Pseudo-Zufallssequenzen daher ist es - üblich, diese über die aktuelle Uhrzeit festzulegen: - <informalexample> - <programlisting role="php"> -// seed with microseconds since last "whole" second -mt_srand((double)microtime()*1000000); +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mt-srand"> + <refnamediv> + <refname>mt_srand</refname> + <refpurpose>Setzt den besseren Zufallszahlengenerator</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>mt_srand</methodname> + <methodparam choice="opt"><type>int</type><parameter>seed</parameter></methodparam> + </methodsynopsis> + <para> + Setzt den Zufallszahlengenerator mit <parameter>seed</parameter> oder mit + einem Zufallswert, wenn <parameter>seed</parameter> nicht angegeben ist. + </para> + ¬e.randomseed; + + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>seed</parameter></term> + <listitem> + <para> + Ein optionaler seed-Wert. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.2.0</entry> + <entry> + Der Parameter <parameter>seed</parameter> wird optional und enthält + standardmäßig einen Zufallswert, sofern er nicht angegeben wurde. + </entry> + </row> + <row> + <entry>Since 5.2.1</entry> + <entry> + Die Mersenne-Twister-Implementation in PHP verwendet jetzt einen + neuen Seeding-Algorithmus von Richard Wagner. Identische Seeds erzeugen + nicht länger die selbe Sequenz von Werten wie in früheren Versionen. + Dieses Verhalten wird nicht als noch einmal wechselnd erwartet, aber es + ist trotzdem nicht sicher, darauf bedingungslos zu vertrauen. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>mt_srand</function>-Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +// seed mit Mikrosekunden +function make_seed() +{ + list($usec, $sec) = explode(' ', microtime()); + return (float) $sec + ((float) $usec * 100000); +} +mt_srand(make_seed()); $randval = mt_rand(); - </programlisting> - </informalexample> - </para> - <note> - <para> - Seit PHP 4.2.0 ist es nicht mehr nötig, den Zufallszahlengenerator zu - initialisieren, bevor man ihn benutzt. - </para> - </note> - <para> - Siehe auch <function>mt_rand</function>, - <function>mt_getrandmax</function>, <function>srand</function>, - <function>rand</function> und <function>getrandmax</function>. - </para> - </refsect1> - </refentry> +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mt_rand</function></member> + <member><function>mt_getrandmax</function></member> + <member><function>srand</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: