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

من موسوعة حسوب
< Ruby‏ | Array
مراجعة 16:48، 8 سبتمبر 2018 بواسطة محمد-بغات (نقاش | مساهمات) (أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.sample</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby Arra...')
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

يختار التابع 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 في توثيق روبي الرسمي.