array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.lcg-value.php', 1 => 'lcg_value', 2 => 'Kongruenzgenerator für Pseudozufallszahlen', ), 'up' => array ( 0 => 'ref.random.php', 1 => 'Random Funktionen', ), 'prev' => array ( 0 => 'function.getrandmax.php', 1 => 'getrandmax', ), 'next' => array ( 0 => 'function.mt-getrandmax.php', 1 => 'mt_getrandmax', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/random/functions/lcg-value.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

lcg_value

(PHP 4, PHP 5, PHP 7, PHP 8)

lcg_value — Kongruenzgenerator für Pseudozufallszahlen

Warnung

Diese Funktion ist seit PHP 8.4.0 als DEPRECATED (veraltet) markiert. Von der Verwendung dieser Funktion wird dringend abgeraten.

Beschreibung

#[\Deprecated]
lcg_value(): float

lcg_value() 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.

Achtung

Diese Funktion erzeugt keine kryptografisch sicheren Werte und darf nicht für kryptografische Zwecke verwendet werden oder für Zwecke, bei denen die zurückgegebenen Werte nicht abschätzbar sein dürfen.

Falls kryptographisch sichere Zufallszahlen benötigt werden, kann der Random\Randomizer mit der Random\Engine\Secure-Engine verwendet werden. Für einfache Anwendungsfälle bieten die Funktionen random_int() und random_bytes() eine bequeme und sichere API, die den CSPRNG des Betriebssystems verwendet.

Achtung

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.

Um einen zufälligen Gleitkommawert innerhalb eines beliebigen Intervalls zu erzeugen, kann Random\Randomizer::getFloat() verwendet werden. Mit Random\Randomizer::getInt() kann eine zufällige Ganzzahl innerhalb eines beliebigen Intervalls erzeugt werden.

Parameter-Liste

Diese Funktion besitzt keine Parameter.

Rückgabewerte

Eine Pseudozufallszahl zwischen 0.0 und 1.0 (inklusive) als float.

Changelog

Version Beschreibung
8.4.0 Diese Funktion ist veraltet.

Siehe auch