التابع Random.rand
في روبي
يعدُّ التابع rand::
اسمًا بديلًا (alias) للتابع Random::DEFAULT.rand
.
البنية العامة
rand → float
rand(max) → number
المعاملات
max
يكون المعامل max
إما عددًا صحيحًا (integer)، أو عددًا عشريًّا (float)، أو مجالًا (range).
القيم المعادة
عندما يكون المعامل max
عددًا صحيحًا، يُعيد التابع rand
عددًا صحيحًا أكبر أو يساوي الصفر وأصغر من max
. خلافًا للتابع Kernel.rand
، يرمي التابع rand
الاستثناء ArgumentError
عندما يكون المعامل max
عددًا صحيحًا سلبيًّا أو صفرًا.
عندما يكون المعامل max
عددًا عشريًّا، يعيد التابع rand
عددًا ذو فاصلة عائمة (floating point) عشوائيًّا يقع بين القيمتين 0.0
و max
متضمنًا القيمة 0.0
وغير متضمَّنٍ للقيمة max
.
أمَّأ عندما يكون المعامل max
مجالًا، فسيعيد التابع rand
عددًا عشوائيًّا يقع ضمن ذلك المجال.
يجب أن تستجيب كِلا قيمتي البداية والنهاية لتوابع الطرح (-) والجمع (+)، أو سيرمي التابع rand
الاستثناء ArgumentError
.
أمثلة
أمثلةٌ على استعمال التابع rand::
:
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
انظر أيضًا
- التابع
rand
: يُعيد عددًا عشوائيًّا يتراوح مجاله بحسب القيمة المُمرَّرة إليه. - التابع
urandom
: يعيد سلسلةً نصيةً (string) باستخدام ميزاتٍ توفرها المنصة. - التابع
bytes
: يُعيد سلسلةً نصيةً ثنائيةً عشوائية بحجم محدَّدٍ من البايتات.