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

يختار التابع sample عنصرًا واحدًا أو عدة عناصر بشكل عشوائي من المصفوفة التي استُدعيت معه. يتم اختيار العناصر باستخدام فهارس عشوائية وفريدة لضمان عدم اختيار العنصر نفسه مجدَّدًا ما لم تحتوِ المصفوفة على عناصر متكررة.

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

 sample → obj
sample(random: rng) → obj
sample(n) → new_ary
sample(n, random: rng) → new_ary

المعاملات

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

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

يعاد عنصر عشوائي من المصفوفة المعطاة، أو مصفوفة جديدة تحوي n من عناصر المصفوفة التي تم اختيارها عشوائيًّا. إن كانت المصفوفة فارغة فسيُعيد الشكل الأول للتابع (انظر القسم «البنية العامة») القيمة nil، وسيعيد الشكل الثاني مصفوفة فارغة.

أمثلة

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

 a = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
a.sample         #=> 7
a.sample(4)      #=> [6, 4, 2, 5]

انظر أيضًا

• التابع shuffle: يعيد ترتيب عناصر مصفوفة بشكل عشوائي ثم يضعها في مصفوفة جديدة.
• التابع select: يحدد جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة.

مصادر

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