الفرق بين المراجعتين لصفحة: «Ruby/Array/sample»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.sample</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby Arra...' |
لا ملخص تعديل |
||
| سطر 4: | سطر 4: | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يختار التابع <code>sample</code> عنصرًا واحدًا أو عدة عناصر بشكل عشوائي من المصفوفة التي استُدعيت معه. | يختار التابع <code>sample</code> عنصرًا واحدًا أو عدة عناصر بشكل عشوائي من المصفوفة التي استُدعيت معه. | ||
يتم اختيار العناصر باستخدام فهارس عشوائية وفريدة لضمان عدم اختيار العنصر نفسه مجدَّدًا ما لم تحتوِ المصفوفة على عناصر متكررة. | يتم اختيار العناصر باستخدام فهارس عشوائية وفريدة لضمان عدم اختيار العنصر نفسه مجدَّدًا ما لم تحتوِ المصفوفة على عناصر متكررة. | ||
==البنية العامة== | ==البنية العامة== | ||
| سطر 12: | سطر 13: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
<code>random</code> | |||
يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي للأعداد التي تمثل فهارس العناصر العشوائية المراد جلبها. قيمته الافتراضية هي: <code>rng</code> | === <code>random</code> === | ||
<code>n</code> | يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي للأعداد التي تمثل فهارس العناصر العشوائية المراد جلبها. قيمته الافتراضية هي: <code>rng</code> | ||
=== <code>n</code> === | |||
عدد صحيح يحدد عدد العناصر العشوائية المراد جلبها من المصفوفة المعطاة. | عدد صحيح يحدد عدد العناصر العشوائية المراد جلبها من المصفوفة المعطاة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 28: | سطر 31: | ||
* التابع [[Ruby/Array/select | <code>select</code>]]: يحدد جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة. | * التابع [[Ruby/Array/select | <code>select</code>]]: يحدد جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع sample في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-sample قسم التابع sample في الصنف Array في توثيق روبي الرسمي.] | ||
مراجعة 16:50، 8 سبتمبر 2018
يختار التابع 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: يحدد جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة.