1
0
mirror of https://github.com/php/doc-de.git synced 2026-03-23 23:02:13 +01:00
Files
archived-doc-de/reference/random/functions/lcg-value.xml
Martin Samesch d4193cb6b9 Sync with EN
2024-12-14 22:05:42 +01:00

117 lines
3.4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: hholzgra Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: 2166824858a40ea664c558f2930b63b8f4fd89c6 Reviewer: samesch -->
<refentry xml:id="function.lcg-value" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>lcg_value</refname>
<refpurpose>Kongruenzgenerator für Pseudozufallszahlen</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-8-4-0;
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>float</type><methodname>lcg_value</methodname>
<void/>
</methodsynopsis>
<para>
<function>lcg_value</function> gibt eine Pseudozufallszahl zwischen Null
und Eins (inklusive) zurück. Die Funktion kombiniert zwei gemischte
kongruente Kongruenzgeneratoren mit den Perioden 2^31 - 85 und 2^31 - 249.
Die Periode der von dieser Funktion generierten Pseudozufallsfolge
entspricht dem Produkt dieser beiden Primzahlen.
</para>
&caution.cryptographically-insecure;
<caution>
<para>
Wenn der Rückgabewert durch Multiplikation oder Addition auf ein anderes
Intervall skaliert wird (eine sogenannte affine Transformation), kann dies
zu einer Verzerrung des resultierenden Wertes führen, weil Gleitkommazahlen
auf der Zahlengeraden nicht gleichmäßig dicht sind. Da nicht alle Werte
exakt durch eine Gleitkommazahl dargestellt werden können, kann das Ergebnis
der affinen Transformation auch zu Werten außerhalb des gewünschten
Intervalls führen.
</para>
<para>
Um einen zufälligen Gleitkommawert innerhalb eines beliebigen Intervalls
zu erzeugen, kann <methodname>Random\Randomizer::getFloat</methodname>
verwendet werden. Mit <methodname>Random\Randomizer::getInt</methodname>
kann eine zufällige Ganzzahl innerhalb eines beliebigen Intervalls
erzeugt werden.
</para>
</caution>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Eine Pseudozufallszahl zwischen 0.0 und 1.0 (inklusive) als
<type>float</type>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Diese Funktion ist veraltet.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>Random\Randomizer::getFloat</methodname></member>
<member><methodname>Random\Randomizer::getInt</methodname></member>
<member><function>random_int</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->