التابع Array.shuffle في روبي

يعيد التابع shuffle ترتيب عناصر مصفوفة بشكل عشوائي ثم يضعها في مصفوفة جديدة.

البنية العامة

huffle → new_ary
shuffle(random: rng) → new_ary

المعاملات

random

يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي لترتيب العناصر بحسب فهرسها. قيمته الافتراضية هي: rng.

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

تعاد مصفوفة جديدة تحوي عناصر المصفوفة المعطاة مرتَّبةً بشكل عشوائي.

أمثلة

أمثلة على استخدام التابع shuffle:

a = [ 1, 2, 3 ]           #=> [1, 2, 3]
a.shuffle                 #=> [2, 3, 1]
a                         #=> [1, 2, 3]
a.shuffle(random: Random.new(1))  #=> [1, 3, 2]

انظر أيضًا

• التابع shuffle!‎: يعيد‎ ترتيب عناصر مصفوفة بشكل عشوائي.
• التابع sort: يرتب عناصر المصفوفة التي استُدعيت معه ويعيدها في مصفوفة جديدة.
• التابع sample: يختار عنصرًا واحدًا أو عدة عناصر بشكل عشوائي من المصفوفة التي استُدعيت معه.

مصادر

• قسم التابع shuffle في الصنف Array في توثيق روبي الرسمي.