[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-doc-cvs
Subject:    [DOC-CVS] =?utf-8?q?svn:_/phpdoc/en/trunk/reference/array/functions/_array-rand.xml?=
From:       Chris_Wright <daverandom () php ! net>
Date:       2013-11-18 18:11:43
Message-ID: svn-daverandom-1384798303-332157-491169053 () svn ! php ! net
[Download RAW message or body]

daverandom                               Mon, 18 Nov 2013 18:11:43 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=332157

Log:
Reworded array_rand so that reader is not addressed as "you", and incorporated edit \
suggested by anonymous 35207

Changed paths:
    U   phpdoc/en/trunk/reference/array/functions/array-rand.xml

Modified: phpdoc/en/trunk/reference/array/functions/array-rand.xml
===================================================================
--- phpdoc/en/trunk/reference/array/functions/array-rand.xml	2013-11-18 18:05:01 UTC \
                (rev 332156)
+++ phpdoc/en/trunk/reference/array/functions/array-rand.xml	2013-11-18 18:11:43 UTC \
(rev 332157) @@ -33,9 +33,7 @@
      <term><parameter>num</parameter></term>
      <listitem>
       <para>
-       Specifies how many entries you want to pick. Trying to pick more
-       elements than there are in the array will result in an
-       <constant>E_WARNING</constant> level error.
+       Specifies how many entries should be picked.
       </para>
      </listitem>
     </varlistentry>
@@ -45,10 +43,12 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   If you are picking only one entry, <function>array_rand</function>
-   returns the key for a random entry. Otherwise, it returns an array
-   of keys for the random entries. This is done so that you can pick
-   random keys as well as values out of the array.
+   When picking only one entry, <function>array_rand</function> returns
+   the key for a random entry. Otherwise, an array of keys for the random
+   entries is returned. This is done so that random keys can be picked
+   from the array as well as random values. Trying to pick more elements
+   than there are in the array will result in an
+   <constant>E_WARNING</constant> level error, and NULL will be returned.
   </para>
  </refsect1>
  <refsect1 role="changelog">



-- 
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

[prev in list] [next in list] [prev in thread] [next in thread]