svn: /phpdoc/de/trunk/reference/math/functions/ mt-getrandmax.xml mt-rand.xml rand.xml

From: 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> - - &note.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

« previous php.doc.de (#4257) next »