svn: /phpdoc/de/trunk/reference/math/functions/ mt-getrandmax.xml mt-rand.xml rand.xml
| From: | Nikita Popov | Date: | Wed, 09 May 2012 11:50:11 +0000 |
| Subject: | svn: /phpdoc/de/trunk/reference/math/functions/ mt-getrandmax.xml mt-rand.xml rand.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-4257@lists.php.net to get a copy of this message | ||
nikic Wed, 09 May 2012 11:50:11 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=325614
Log:
Sync random function docs
Changed paths:
U phpdoc/de/trunk/reference/math/functions/mt-getrandmax.xml
U phpdoc/de/trunk/reference/math/functions/mt-rand.xml
U phpdoc/de/trunk/reference/math/functions/rand.xml
Modified: phpdoc/de/trunk/reference/math/functions/mt-getrandmax.xml
===================================================================
--- phpdoc/de/trunk/reference/math/functions/mt-getrandmax.xml 2012-05-09 11:22:20 UTC (rev 325613)
+++ phpdoc/de/trunk/reference/math/functions/mt-getrandmax.xml 2012-05-09 11:50:11 UTC (rev 325614)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 305123 Maintainer: sammywg Status: ready -->
<refentry xml:id="function.mt-getrandmax" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mt_getrandmax</refname>
@@ -24,6 +24,32 @@
erzeugen kann.
</para>
</refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example><title>Berechnung einer zufälligen Gleitkommazahl</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function randomFloat($min = 0, $max = 1) {
+ return $min + mt_rand() / mt_getrandmax() * ($max - $min);
+}
+
+var_dump(randomFloat());
+var_dump(randomFloat(2, 20));
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+float(0.91601131712832)
+float(16.511210331931)
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
Modified: phpdoc/de/trunk/reference/math/functions/mt-rand.xml
===================================================================
--- phpdoc/de/trunk/reference/math/functions/mt-rand.xml 2012-05-09 11:22:20 UTC (rev 325613)
+++ phpdoc/de/trunk/reference/math/functions/mt-rand.xml 2012-05-09 11:50:11 UTC (rev 325614)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 315633 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>
@@ -116,6 +116,18 @@
</example>
</para>
</refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <caution>
+ <para>
+ Wenn <parameter>max</parameter> größer als <literal>2^32</literal>
+ ist (auf einem 64-bit System), dann sind die Rückgabewerte von
+ <function>mt_rand</function> bevorzugt gerade Zahlen, d.h. die
+ Rückgabewerte sind nicht mehr strikt gleichverteilt.
+ </para>
+ </caution>
+ </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
Modified: phpdoc/de/trunk/reference/math/functions/rand.xml
===================================================================
--- phpdoc/de/trunk/reference/math/functions/rand.xml 2012-05-09 11:22:20 UTC (rev 325613)
+++ phpdoc/de/trunk/reference/math/functions/rand.xml 2012-05-09 11:50:11 UTC (rev 325614)
@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 -->
-<!-- EN-Revision: n/a Maintainer: hholzgra Status: working -->
-<!-- Rev-Revision: 1.0 Reviewer: sammywg -->
+<!-- EN-Revision: 315160 Maintainer: nikic Status: working -->
+<!-- CREDITS: hholzgra -->
<refentry xml:id="function.rand" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>rand</refname>
- <refpurpose>Erzeugt einen zufälligen Integerwert</refpurpose>
+ <refpurpose>Erzeugt eine zufällige Zahl</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@@ -21,22 +21,19 @@
<simpara>
Liefert eine Pseudozufallszahl zwischen <parameter>min</parameter>
und <parameter>max</parameter> (inklusive), oder zwischen 0
- und <function>get_randmax</function> falls keine Parameter angegeben wurden.
+ und <function>getrandmax</function>, falls keine Parameter angegeben wurden.
Wenn Sie z.B. einen Zufallswert zwischen 5 und 15 benötigen
so wäre der Aufruf dafür <literal>rand(5, 15)</literal>.
</simpara>
<note>
<simpara>
- Auf manchen Plattformen (Windows z.B.) ist <function>get_randmax</function>
- nur 32768. Wenn sie einen größeren Wertebereich benötigen sollten, so
+ Auf manchen Plattformen (z.B. Windows) ist <function>getrandmax</function>
+ nur 32767. Wenn sie einen größeren Wertebereich benötigen sollten, so
können Sie entweder einen größeren <parameter>max</parameter>-Wert
übergeben oder besser die <function>mt_rand</function>-Funktion
anstelle von <function>rand</function> einsetzen.
</simpara>
</note>
-
- ¬e.randomseed;
-
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -54,7 +51,7 @@
<term><parameter>max</parameter></term>
<listitem>
<para>
- Der höchste zurückzugebende Wert (Vorgabe: <function>get_randmax</function>)
+ Der höchste zurückzugebende Wert (Vorgabe: <function>getrandmax</function>)
</para>
</listitem>
</varlistentry>
@@ -65,7 +62,7 @@
&reftitle.returnvalues;
<para>
Ein Pseudozufallswert zwischen <parameter>min</parameter>
- (oder 0) und <parameter>max</parameter> (oder
<function>get_randmax</function>, inklusive).
+ (oder 0) und <parameter>max</parameter> (oder
<function>getrandmax</function>, inklusive).
</para>
</refsect1>
<refsect1 role="changelog">
@@ -80,16 +77,7 @@
</row>
</thead>
<tbody>
- <row>
- <entry>Seit 3.0.7</entry>
- <entry>
- In Versionen vor 3.0.7 war die Bedeutung von
- <parameter>max</parameter> statt dessen
<parameter>range</parameter>.
- Um in diesen Versionen das gleiche Ergebnis zu erzielen muss im
- folgenden Beispiel <literal>rand (5, 11)</literal> benutzt werden
- um eine Zufallszahl zwischen 5 und 15 zu erhalten.
- </entry>
- </row>
+ &changelog.randomseed;
</tbody>
</tgroup>
</informaltable>
@@ -99,7 +87,7 @@
&reftitle.examples;
<para>
<example>
- <title><function>rand</function> example</title>
+ <title><function>rand</function> Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php