الفرق بين المراجعتين لصفحة: «PHP/array rand»

من موسوعة حسوب
< PHP
سطر 46: سطر 46:


== مصادر ==
== مصادر ==
<span> </span>
* [http://php.net/manual/en/function.array-rand.php صفحة الدالة array_rand في توثيق PHP الرسمي].
* [http://php.net/manual/en/function.array-rand.php صفحة الدالة array_rand()‎ في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]
[[تصنيف:PHP Array]]

مراجعة 13:49، 21 مارس 2018

(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";
?>

انظر أيضًا

مصادر