array section sync with EN (#835)

php · Mar 7, 2024 · bead730 · bead730
1 parent 130f1e5
commit bead730
Showing 1 changed file with 28 additions and 5 deletions.
diff --git a/reference/array/functions/array-rand.xml b/reference/array/functions/array-rand.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: fc1e94a9c2e271c7cefd86f28a1cb5bc30a52664 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 4a1dedc24b1e085f298ab1d5dadefe306373691b Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <!-- CREDITS: DavidA. -->
 
@@ -32,6 +32,7 @@
      <listitem>
       <para>
        Le tableau d'entrée.
+       Ne peut pas être vide.
       </para>
      </listitem>
     </varlistentry>
@@ -40,6 +41,7 @@
      <listitem>
       <para>
        Spécifie le nombre d'entrées que vous voulez récupérer.
+       Doit être supérieur à zéro et inférieur ou égal à la longueur de <parameter>array</parameter>.
       </para>
      </listitem>
     </varlistentry>
@@ -55,10 +57,15 @@
    aléatoirement. Sinon, un tableau de clés d'entrées aléatoires sera
    retourné. Cela vous permet de faire une sélection au hasard de clés,
    ou bien de valeurs. Si plusieurs clés sont retournées, alors elles le
-   seront dans l'ordre qu'elles étaient dans le tableau d'origine   
-   Le fait de tenter de récupérer plus d'éléments
-   qu'il n'y en a dans le tableau fera qu'une erreur de niveau
-   <constant>E_WARNING</constant> sera émise, et NULL sera retourné.
+   seront dans l'ordre qu'elles étaient dans le tableau d'origine.  
+  </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Lance une <classname>ValueError</classname> si <parameter>array</parameter> est vide,
+   ou si <parameter>num</parameter> est hors de portée.
   </para>
  </refsect1>
 
@@ -74,6 +81,22 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        <function>array_rand</function> lance désormais une <classname>ValueError</classname>
+        si <parameter>num</parameter> est hors de portée ; précédemment, un
+        <constant>E_WARNING</constant> était généré et la fonction renvoyait &null;.
+       </entry>
+      </row>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        <function>array_rand</function> lance désormais une <classname>ValueError</classname>
+        si <parameter>array</parameter> est vide ; précédemment, un
+        <constant>E_WARNING</constant> était généré et la fonction renvoyait &null;.
+       </entry>
+      </row>
       <row>
        <entry>7.1.0</entry>
        <entry>