array_rand()
< PHP
(PHP 4, PHP 5, PHP 7)
تختار الدالة array_rand() واحدًا أو أكثر من عناصر المصفوفة عشوائيًا.
الوصف
mixed array_rand ( array $array [, int $num = 1 ] )
تختار الدالة array_rand() واحدًا أو أكثر من عناصر المصفوفة عشوائيًا، وتعيد مفتاح (أو مفاتيح) العناصر عشوائيًا. وتستخدم مولد أرقام عشوائية زائفة غير مناسب لأغراض التشفير.
المعاملات
array
المصفوفة المُدخلة.
num
يحدد عدد العناصر التي يجب اختيارها عشوائيًا.
القيم المعادة
عند اختيار إدخال واحد فقط، تُعيد الدالة array_rand() مفتاحًا لعنصرٍ واحد عشوائيًا. خلاف ذلك، ستعاد مصفوفة مفاتيح عناصر عشوائية. وذلك عن طريق اختيار مفاتيح عناصر عشوائية من المصفوفة وكذلك قيم هذه العناصر. ستؤدي محاولة اختيار عناصر أكثر من الموجودة في المصفوفة إلى حدوث خطأ من المستوى E_WARNING، وستُعاد القيمة NULL.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 7.1.0 | تغيير خوارزمية العشوائية الداخلية لاستخدام مولد أرقام Mersenne Twister العشوائي بدلاً من دالة libc rand.
|
| 5.2.10 | إيقاف خلط مصفوفة المفاتيح الناتجة |
أمثلة
المثال 1: مثال على الدالة array_rand()
<?php
$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$rand_keys = array_rand($input, 2);
echo $input[$rand_keys[0]] . "\n";
echo $input[$rand_keys[1]] . "\n";
?>
انظر أيضًا
shuffle(): خلط عناصر مصفوفة.