عرض مصدر Ruby/Random/rand

{{DISPLAYTITLE:التابع <code>Random.rand</code> في روبي}}
يُعيد التابع <code>rand</code> عددًا عشوائيًّا يتراوح مجاله بحسب القيمة المُمرَّرة إليه.

== البنية العامة ==
<syntaxhighlight lang="ruby">
rand → float
rand(max) → number

</syntaxhighlight>

== المعاملات ==

=== <code>max</code> ===
يكون المعامل <code>max</code> إما عددًا صحيحًا (integer)، أو عددًا عشريًّا (float)، أو مجالًا (range).

== القيم المعادة ==
عندما يكون المعامل <code>max</code>عددًا صحيحًا، يُعيد التابع <code>rand</code> عددًا صحيحًا أكبر أو يساوي الصفر وأصغر من <code>max</code>. خلافًا للتابع <code>[[Ruby/Kernel/rand|Kernel.rand]]</code>، يرمي التابع <code>rand</code> الاستثناء ArgumentError عندما يكون المعامل <code>max</code>عددًا صحيحًا سالبًاأو صفرًا.

عندما يكون المعامل <code>max</code>عددًا عشريًّا، يعيد التابع <code>rand</code>عددًا ذو فاصلة عشرية (floating point) عشوائيًّا يقع بين القيمتين <code>0.0</code> و <code>max</code>متضمنًا القيمة <code>0.0</code> وغير متضمَّنٍ للقيمة <code>max</code>.

عندما يكون المعامل <code>max</code>مجالًا، يعيد التابع <code>rand</code>عددًا عشوائيًّا يقع ضمن هذا المجال.

يجب أن تستجيب كِلا قيمتي البداية والنهاية لتوابع الطرح (-) والجمع (+)، أو سيرمي التابع <code>rand</code>الاستثناء <code>ArgumentError</code>.

== أمثلة ==
أمثلة على استعمال التابع <code>rand</code>:<syntaxhighlight lang="ruby">
prng = Random.new
prng.rand(100)       # => 42

prng.rand(1.5)       # => 1.4600282860034115

prng.rand(5..9)      # => one of [5, 6, 7, 8, 9]
prng.rand(5...9)     # => one of [5, 6, 7, 8]
prng.rand(5.0..9.0)  # => between 5.0 and 9.0, including 9.0
prng.rand(5.0...9.0) # => between 5.0 and 9.0, excluding 9.0

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Ruby/Random/urandom|urandom]]</code> : يعيد سلسلةً نصيةً (string) باستخدام ميزاتٍ توفرها المنصة.
* التابع <code>[[Ruby/Random/bytes|bytes]]</code> : يُعيد سلسلةً نصيةً ثنائيةً عشوائية بحجم محدَّدٍ من البايتات.
* التابع <code>[[Ruby/Random/srand|srand]]</code>: يحدِّد بذرة مولد الأعداد شبه العشوائية للنظام بتعيين <code>Random::DEFAULT</code> إلى القيمة المُمرَّرة إليه.

== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Random.html#method-i-rand صفحة التابع rand في الصنف Random في توثيق روبي الرسمي.]
[[تصنيف:Ruby]]
[[تصنيف:Ruby Method]]
[[تصنيف:Ruby Random]]