عرض مصدر Ruby/Array/shuffle!

<noinclude>{{DISPLAYTITLE: التابع <code>Array.shuffle!‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يعيد التابع <code>shuffle!</code>!‎ ترتيب عناصر مصفوفة بشكل عشوائي.
==البنية العامة==
<syntaxhighlight lang="ruby"> shuffle! → ary
shuffle!(random: rng) → ary
 </syntaxhighlight>
==المعاملات==
<code>random</code>
يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي لترتيب العناصر بحسب فهرسها. قيمته الافتراضية هي: <code>rng</code>.
==القيم المعادة==
تعاد المصفوفة نفسها المعطاة بعد ترتيب عناصرها بشكل عشوائي.
==أمثلة==
أمثلة على استخدام التابع <code>shuffle!</code>!‎:
<syntaxhighlight lang="ruby"> a = [ 1, 2, 3 ]           #=> [1, 2, 3]
a.shuffle!                #=> [2, 3, 1]
a                         #=> [2, 3, 1]
a.shuffle!(random: Random.new(1))  #=> [1, 3, 2]

 </syntaxhighlight>
==انظر أيضًا==
* التابع [[Ruby/Array/shuffle | <code>shuffle</code>]]: يعيد ترتيب عناصر مصفوفة بشكل عشوائي ثم يضعها في مصفوفة جديدة.
* التابع [[Ruby/Array/sort! | <code>sort!</code>]]!‎: يرتب عناصر المصفوفة التي استُدعيت معه.
* التابع [[Ruby/Array/sample | <code>sample</code>]]: يختار عنصرًا واحدًا أو عدة عناصر بشكل عشوائي من المصفوفة التي استُدعيت معه.
==مصادر==
* قسم التابع shuffle!‎ في الصنف Array في توثيق روبي الرسمي.