الدالة srand()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تحدِّد الدالة srand()‎ البذرة (seed) المستعملة في خوارزميَّة توليد أعداد عشوائيَّة.

الوصف

void srand ([ int $seed ] )

تحدِّد هذه الدالة البذرة المستعملة في خوارزميَّة توليد الأعداد العشوائيَّة. تكون قيمة البذرة هي المعامل seed المُمرَّر  إلى الدالة، وإن لم يُعطَ هذا المعامل فستكون قيمة البذرة هي قيمة عشوائيَّة.

ملاحظة: لا حاجة لتحديد قيمة البذرة باستدعاء هذه الدالة أو الدالة mt_srand()‎ في كل مرة تريد فيها توليد أعداد عشوائيَّة، سواءً باستعمال الدالة rand()‎ أو الدالة mt_rand()‎، إذ تُحدَّد قيمة البذرة آنذاك تلقائيًّا.

المعاملات

seed

قيمة عدديَّة صحيحة التي ستُحدِّد قيمة البذرة.

القيم المعادة

لا توجد أي قيمة معادة.

سجل التغييرات

الإصدار	الوصف
7.1.0	أصبحت الدالة اسمًا بديلًا عن الدالة mt_srand()‎ أي أنَّها تشير إليها.

أمثلة

المثال 1: استعمال الدالة srand()‎

<?php
// تحديد البذرة باستعمال الثواني
function make_seed()
{
  list($usec, $sec) = explode(' ', microtime());
  return $sec + $usec * 1000000;
}
srand(make_seed());
$randval = rand();
?>

انظر أيضًا

• الدالة rand()‎: تولِّد قيمة عدديَّة عشوائيَّة صحيحة.
• الدالة getrandmax()‎: تعيد أكبر قيمة عدديَّة عشوائيَّة يمكن أن تولِّدها الدالة rand()‎.
• الدالة mt_srand()‎: تحديد البذرة المستعملة في خوارزميَّة Mersenne Twister لتوليد أعداد عشوائيَّة.

مصادر

• صفحة الدالة srand في توثيق PHP الرسمي.