الفرق بين المراجعتين ل"PHP/mt rand"

من موسوعة حسوب
< PHP
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'PHP\/Function\/([^|]*)' ب'PHP/$1')
ط (نقل عبد اللطيف ايمش صفحة PHP/Function/mt-rand إلى PHP/mt rand: إعادة هيكلة التوثيق)
 
(مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين)
سطر 8: سطر 8:
 
int mt_rand ( void )
 
int mt_rand ( void )
 
int mt_rand ( int $min , int $max ))
 
int mt_rand ( int $min , int $max ))
</syntaxhighlight>تنبيه: لا تولِّد هذه الدالة أي قيم آمنة، لذا لا يجب استعمالها لغرض التشفير مطلقًا. إن أردت توليد قيم آمنة مشفَّرة، فاستعمل الدالة <code>[[PHP/random-int|random_int()‎]]</code> أو الدالة <code>[[PHP/random-bytes|random_bytes()]]‎</code> أو الدالة <code>[[PHP/openssl-random-pseudo-bytes|openssl_random_pseudo_bytes()‎]]</code>.
+
</syntaxhighlight>تنبيه: لا تولِّد هذه الدالة أي قيم آمنة، لذا لا يجب استعمالها لغرض التشفير مطلقًا. إن أردت توليد قيم آمنة مشفَّرة، فاستعمل الدالة <code>[[PHP/random_int|random_int()‎]]</code> أو الدالة <code>[[PHP/random_bytes|random_bytes()]]‎</code> أو الدالة <code>[[PHP/openssl_random_pseudo_bytes|openssl_random_pseudo_bytes()‎]]</code>.
  
 
تعيد معظم الخوارزميات التي تستعملها الدوال التابعة لمكتبة <code>libcs</code> لتوليد أعداد عشوائيَّة قيمًا مريبة أو ذات خصائص غير معروفة وتكون بطيئة في توليد الأعداد بعض الشيء. إن وازنَّا الدالة <code>mt_rand()‎</code> مع الدالة <code>rand()‎</code>، نجد أنَّ الأولى تستعمل خوارزميَّة Mersenne Twister لتوليد أعداد شبه عشوائيَّة ذات خصائص معلومة وتُنفَّذ بطريقة أسرع بأربع أضعاف بالموازنة مع الخوارزميَّة التي تستعملها الدالة الثانية، لذا نجد أنَّ الدالة <code>mt_rand()‎</code> حلت مكان الدالة <code>[[PHP/rand|rand()‎]]</code> التابعة لمكتبة <code>libcs</code>.
 
تعيد معظم الخوارزميات التي تستعملها الدوال التابعة لمكتبة <code>libcs</code> لتوليد أعداد عشوائيَّة قيمًا مريبة أو ذات خصائص غير معروفة وتكون بطيئة في توليد الأعداد بعض الشيء. إن وازنَّا الدالة <code>mt_rand()‎</code> مع الدالة <code>rand()‎</code>، نجد أنَّ الأولى تستعمل خوارزميَّة Mersenne Twister لتوليد أعداد شبه عشوائيَّة ذات خصائص معلومة وتُنفَّذ بطريقة أسرع بأربع أضعاف بالموازنة مع الخوارزميَّة التي تستعملها الدالة الثانية، لذا نجد أنَّ الدالة <code>mt_rand()‎</code> حلت مكان الدالة <code>[[PHP/rand|rand()‎]]</code> التابعة لمكتبة <code>libcs</code>.
سطر 63: سطر 63:
 
* الدالة <code>[[PHP/mt srand|mt_srand()‎]]</code>: تحديد البذرة (seed) المستخدمة في خوارزميَّة Mersenne Twister لتوليد أعداد عشوائيَّة.
 
* الدالة <code>[[PHP/mt srand|mt_srand()‎]]</code>: تحديد البذرة (seed) المستخدمة في خوارزميَّة Mersenne Twister لتوليد أعداد عشوائيَّة.
 
* الدالة <code>[[PHP/mt getrandmax|mt_getrandmax()‎]]</code>: تعيد أكبر قيمة عشوائيَّة محتملة يمكن أن تولِّدها الدالة <code>mt_rand()‎</code>.
 
* الدالة <code>[[PHP/mt getrandmax|mt_getrandmax()‎]]</code>: تعيد أكبر قيمة عشوائيَّة محتملة يمكن أن تولِّدها الدالة <code>mt_rand()‎</code>.
* الدالة <code>[[PHP/random-int|random_int()‎]]</code>: تولِّد [[PHP/integer|عددًا صحيحًا]] آمنًا شبه عشوائي يمكن استعماله لغرض التشفير.
+
* الدالة <code>[[PHP/random_int|random_int()‎]]</code>: تولِّد [[PHP/integer|عددًا صحيحًا]] آمنًا شبه عشوائي يمكن استعماله لغرض التشفير.
* الدالة <code>[[PHP/random-bytes|random_bytes()‎]]</code>: تولِّد [[PHP/string|سلسلة نصيَّة (string)]] شبه عشوائيَّة ذات حجم محدَّد يمكن استعمالها لغرض التشفير.
+
* الدالة <code>[[PHP/random_bytes|random_bytes()‎]]</code>: تولِّد [[PHP/string|سلسلة نصيَّة (string)]] شبه عشوائيَّة ذات حجم محدَّد يمكن استعمالها لغرض التشفير.
* الدالة <code>[[PHP/openssl-random-pseudo-bytes|openssl_random_pseudo_bytes()‎]]</code>: تولِّد [[PHP/string|سلسلة نصيَّة (string)]] شبه عشوائيَّة ذات حجم محدَّد.
+
* الدالة <code>[[PHP/openssl_random_pseudo_bytes|openssl_random_pseudo_bytes()‎]]</code>: تولِّد [[PHP/string|سلسلة نصيَّة (string)]] شبه عشوائيَّة ذات حجم محدَّد.
 
* الدالة <code>[[PHP/rand|rand()‎]]</code>: تولِّد قيمة عدديَّة عشوائيَّة صحيحة.
 
* الدالة <code>[[PHP/rand|rand()‎]]</code>: تولِّد قيمة عدديَّة عشوائيَّة صحيحة.
  

المراجعة الحالية بتاريخ 03:50، 4 أبريل 2018

(PHP 4, PHP 5, PHP 7)

تولِّد الدالة mt_rand()‎ عددًا صحيحًا شبه عشوائي (pseudo-random integer) وتعيده وذلك باستعمال خوارزميَّة Mersenne Twister.

الوصف

int mt_rand ( void )
int mt_rand ( int $min , int $max ))

تنبيه: لا تولِّد هذه الدالة أي قيم آمنة، لذا لا يجب استعمالها لغرض التشفير مطلقًا. إن أردت توليد قيم آمنة مشفَّرة، فاستعمل الدالة random_int()‎ أو الدالة random_bytes() أو الدالة openssl_random_pseudo_bytes()‎.

تعيد معظم الخوارزميات التي تستعملها الدوال التابعة لمكتبة libcs لتوليد أعداد عشوائيَّة قيمًا مريبة أو ذات خصائص غير معروفة وتكون بطيئة في توليد الأعداد بعض الشيء. إن وازنَّا الدالة mt_rand()‎ مع الدالة rand()‎، نجد أنَّ الأولى تستعمل خوارزميَّة Mersenne Twister لتوليد أعداد شبه عشوائيَّة ذات خصائص معلومة وتُنفَّذ بطريقة أسرع بأربع أضعاف بالموازنة مع الخوارزميَّة التي تستعملها الدالة الثانية، لذا نجد أنَّ الدالة mt_rand()‎ حلت مكان الدالة rand()‎ التابعة لمكتبة libcs.

تعيد الدالة mt_rand()‎ عددًا شبه عشوائي تنحصر قيمته بين 0 وقيمة الدالة mt_getrandmax()‎ إن استدعيت دون تمرير المعاملين الاختياريين min و max. أمَّا إن أردت توليد عدد عشوائي تنحصر قيمته في مجال محدَّد، فاستعمل المعامل min والمعامل max لتحديد ذلك المجال.

المعاملات

min

أدنى قيمة يمكن أن تعيدها الدالة. قيمته الافتراضيَّة هي 0.

max

أعلى قيمة يمكن أن تعيدها الدالة. قيمته الافتراضيَّة هي قيمة الدالة mt_getrandmax()‎.

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

يُعاد عددًا صحيحًا شبه عشوائي يتراوح مجاله بين 0 - mt_getrandmax()‎ إن لم يمرَّر أي معامل أو يترواح مجاله بين max - min في حال تحديد قيم هذين المعاملين. إن كانت قيمة المعامل max أصغر من قيمة المعامل min، فستُعاد القيمة FALSE.

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

الإصدار الوصف
7.2.0 إصلاح خطأ يتعلق بجعل القيم غير موزعة بانتظام أي منحازة باتجاه متتالية معيَّنة (modulo bias). هذا يعني أنَّ سلسلة الأعداد المولدة باستعمال بذرة محدَّدة قد تختلف عن تلك المولدة باستعمال إصدار PHP 7.1 على نظام ذو 64 بت.
7.1.0 أصبحت الدالة rand()‎ اسمًا بديلًا (alias) عن الدالة mt_rand()‎أي أنَّها تشير إليها.
7.1.0 تستعمل الدالة mt_rand()‎ النسخة المعدَّلة الصحيحة من خوارزميَّة Mersenne Twister. يمكن الرجوع إلى النسخة السابقة -ما قبل التعديل- بتحديد الثابت MT_RAND_PHP للمعامل mode في الدالة mt_srand().
5.3.4 إظهار الخطأ E_WARNING وإعادة القيمة FALSE إن كانت قيمة max أصغر من قيمة min أي max < min.

أمثلة

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

<?php
echo mt_rand() . "\n";
echo mt_rand() . "\n";

echo mt_rand(5, 15);
?>

سيُظهر المثال السابق نتيجة شبيه بالنتيجة التالية:

1604716014
1478613278
6

ملاحظات

يجب أن تكون قيمة المعامل min والمعامل max أصغر من قيمة الدالة mt_getrandmax()‎ أي ضمن المجال 0 - mt_getrandmax()‎. قد يؤدي اختيار قيم أعلى من هذا المجال إلى إعادة أعداد عشوائيَّة ذات دقة سيئة.

انظر أيضًا

مصادر