mt_rand() はPHP 8.0以降ValueError をスローする (php/doc-en#4660)

Author: takaram

reference/random/functions/mt-rand.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0b6c76516a299395a3703e6df44f8ea4cb4549a8 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 0a5e7b12546b62a611a0cbc7105e617ab96fbcbd Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi,mumumu -->
 <refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -65,10 +65,19 @@
    <parameter>min</parameter> (あるいは 0)
    から <parameter>max</parameter> (あるいは <function>mt_getrandmax</function>、それぞれ端点を含む)
    までの間のランダムな整数値を返します。
-   <parameter>max</parameter> が <parameter>min</parameter> より小さい場合は
-   &false; を返します。
   </para>
  </refsect1>
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <parameter>max</parameter> が <parameter>min</parameter> より小さい場合
+     <classname>ValueError</classname> がスローされます。
+    </simpara>
+   </listitem>
+  </itemizedlist>
+ </refsect1>
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -81,6 +90,14 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        <parameter>max</parameter> が <parameter>min</parameter> より小さい場合は
+        <classname>ValueError</classname> がスローされます。
+        以前は <constant>E_WARNING</constant> が発生し、関数は &false; を返していました。
+       </entry>
+      </row>
       <row>
        <entry>7.2.0</entry>
        <entry>
@@ -92,7 +109,7 @@
       <row>
        <entry>7.1.0</entry>
        <entry>
-        <function>rand</function> は、<function>mt_rand</function> の 
+        <function>rand</function> は、<function>mt_rand</function> の
         <link linkend="migration71.incompatible.rand-srand-aliases">エイリアスになりました。</link>
        </entry>
       </row>