الدالة `shuffle()‎‎‎‎‎‎‎‎‎‎‎‎` في PHP

(PHP 4, PHP 5, PHP 7)

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

الوصف

bool shuffle ( 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. وستزيل أي مفاتيح موجودة قد سبق تعيينها، بدلاً من مجرد إعادة ترتيب المفاتيح.