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

{{DISPLAYTITLE:التابع <code>Random.rand</code> في روبي}}
يعدُّ التابع <code>rand::</code> اسمًا بديلًا (alias) للتابع <code>[[Ruby/Random/rand|Random::DEFAULT.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>الاستثناء <code>ArgumentError</code> عندما يكون المعامل <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/rand|rand]]</code>: يُعيد عددًا عشوائيًّا يتراوح مجاله بحسب القيمة المُمرَّرة إليه.
* التابع <code>[[Ruby/Random/urandom|urandom]]</code>: يعيد سلسلةً نصيةً (string) باستخدام ميزاتٍ توفرها المنصة.
* التابع <code>[[Ruby/Random/bytes|bytes]]</code>: يُعيد سلسلةً نصيةً ثنائيةً عشوائية بحجم محدَّدٍ من البايتات.

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