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

(PHP 4, PHP 5, PHP 7)

تعيد الدالة mt_getrandmax()‎ أكبر قيمة عشوائيَّة محتملة.

الوصف

int mt_getrandmax ( void )

تعيد هذه الدالة أكبر قيمة يمكن أن تعيدها الدالة mt_rand()‎ عند استدعائها.

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

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

أمثلة

المثال 1: إيجاد عدد عشري عشوائي

<?php
function randomFloat($min = 0, $max = 1) {
    return $min + mt_rand() / mt_getrandmax() * ($max - $min);
}

var_dump(randomFloat());
var_dump(randomFloat(2, 20));
?>

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

float(0.91601131712832)
float(16.511210331931)

انظر أيضًا

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

مصادر

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