1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xml:id="function.mt-srand" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mt_srand</refname>
<refpurpose>Seeds the Mersenne Twister Random Number Generator</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>mt_srand</methodname>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>seed</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>MT_RAND_MT19937</constant></initializer></methodparam>
</methodsynopsis>
<para>
Seeds the random number generator with
<parameter>seed</parameter> or with a random value
if no <parameter>seed</parameter> is given.
</para>
¬e.randomseed;
&caution.mt19937-tiny-seed;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>seed</parameter></term>
<listitem>
<para>
Fills the state with values generated with a linear congruential generator
that was seeded with <parameter>seed</parameter> interpreted as an unsigned
32 bit integer.
</para>
<para>
If <parameter>seed</parameter> is omitted or &null;, a random unsigned
32-bit integer will be used.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Use one of the following constants to specify the implementation of the algorithm to use.
<simplelist>
<member>
<constant>MT_RAND_MT19937</constant>:
The correct Mt19937 implementation, available as of PHP 7.1.0.
</member>
<member>
<constant>MT_RAND_PHP</constant>
Uses an incorrect Mersenne Twister implementation which was used as the default up till PHP 7.1.0.
This mode is available for backward compatibility.
</member>
</simplelist>
</para>
&warn.deprecated.feature-8-3-0;
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.void;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>seed</parameter> is now nullable.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
<function>srand</function> <link linkend="migration71.incompatible.rand-srand-aliases">has been made</link> an alias of <function>mt_srand</function>.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
<function>mt_rand</function> <link linkend="migration71.incompatible.fixes-to-mt_rand-algorithm">has been updated</link> to use the fixed, correct, version of
the Mersenne Twister algorithm. To fall back to the old behaviour, use <function>mt_srand</function> with <constant>MT_RAND_PHP</constant> as the second parameter.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mt_rand</function></member>
<member><function>mt_getrandmax</function></member>
<member><function>srand</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
-->
|
