<?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

-->