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

{{DISPLAYTITLE:التابع <code>Random.srand</code> في روبي}}
يحدِّد التابع <code>srand</code> بذرة مولد الأعداد شبه العشوائية (pseudo-random number generator) للنظام، بتعيين <code>Random::DEFAULT</code>، إلى القيمة المُمرَّرة إليه. يعيد التابع بعد استدعائه قيمة البذرة السابقة.

في حال عدم أية قيمة إلى التابع <code>srand</code>، فسيبذُر المولد باستخدام مصدر للعشوائية (entropy) يوفره نظام التشغيل إن كان متاحًا (‎/dev/urandom على أنظمة Unix أو مُوفِّر خوارزمية التشفير [RSA] على نظام Windows)؛ تدمج هذه البذرة بين الوقت، ومعرف العملية (pid)، ورقم التسلسل لتوليدها من أجل أن تكون العشوائية كافية.

يمكن استخدام <code>srand</code> لضمان تكرار تسلسلات الأعداد شبه العشوائية بين عمليات التشغيل المختلفة للبرنامج. فعبر ضبط قيم البذرة إلى قيم معروفة، يمكن جعل سلوك البرامج محدِّدة وغير عشوائية أثناء الاختبار.

== البنية العامة ==
<syntaxhighlight lang="ruby">
srand(number = Random.new_seed) → old_seed
</syntaxhighlight>

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

=== <code>number</code> ===
قيمة البذرة المراد تعيينها لمولد الأعداد العشوائية.

== القيم المعادة ==
تُعاد قيمة البذرة السابقة.

== أمثلة ==
مثالٌ عن استخدام التابع <code>srand</code>:<syntaxhighlight lang="ruby">
srand 1234               # => 268519324636777531569100071560086917274
[ rand, rand ]           # => [0.1915194503788923, 0.6221087710398319]
[ rand(10), rand(1000) ] # => [4, 664]
srand 1234               # => 1234
[ rand, rand ]           # => [0.1915194503788923, 0.6221087710398319]

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Ruby/Random/new|new]]</code>: يُنشئ مولِّد أعدادٍ شبه عشوائيةٍ (PRNG) باستخدام قيمة محدَّدة للبذرة لضبط الحالة الأولية.
* التابع <code>[[Ruby/Random/new seed|new_seed]]</code>: يعيد قيمةً عشوائية تمثِّل البذرة.
* التابع <code>[[Ruby/Random/seed|seed]]</code>: يعيد قيمة البذرة التي استُخدمَت في إنشاء المولِّد.

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