PHP/shuffle

(PHP 4, PHP 5, PHP 7)

تخلط الدالة shuffle()‎ عناصر المصفوفة.

الوصف

bool shuffle ( array &$array )

تخلط هذه الدالة عناصر المصفوفة بإعادة ترتيبها عشوائيًا. وتستخدم مولد أرقام عشوائية زائفة غير مناسب لأغراض التشفير.

ملاحظة: إذا تساوت مقارنة عنصرين، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد.

المعاملات

array

المصفوفة المُدخلة.

القيم المعادة

تُعيد الدالة القيمة TRUE عند نجاح عملها، أو FALSE عند فشل تنفيذها.

سجل التغييرات

الإصدار	الوصف
7.1.0	تغيير الخوارزمية العشوائية الداخلية لاستخدام "مولد أرقام Mersenne Twister العشوائي" بدلاً من الدالة rand.

أمثلة

المثال 1: مثال على الدالة shuffle()‎‎

<?php
$numbers = range(1, 20);
shuffle($numbers);
foreach ($numbers as $number) {
    echo "$number ";
}
?>

ملاحظات

ملاحظة: تُعيّن هذه الدالة مفاتيح جديدة للعناصر في المصفوفة array. وستزيل أي مفاتيح موجودة قد سبق تعيينها، بدلاً من مجرد إعادة ترتيب المفاتيح.

انظر أيضًا

• الدالة array_rand()‎: اختيار عنصرٍ أو أكثر من عناصر المصفوفة عشوائيًا.
• مقارنة بين دوال ترتيب المصفوفة.

مصادر

• صفحة الدالة shuffle في توثيق PHP الرسمي.