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

(PHP 4, PHP 5, PHP 7)

تُحدِّد الدالة is_numeric()‎‎‎‎‎‎‎‎‎ ما إذا كان المتغيّر عدديًّا أو سلسلة نصّيّة عدديّة.

الوصف

bool is_numeric ( mixed $var )

تُحدِّد ما إذا كان المتغيّر المُعطى عدديًّا، تتكوّن السّلاسل النصّيّة العدديّة من إشارة اختياريّة، وأي عدد مُكوَّن من أرقام، وجزء عشري اختياري، وجزء أسّي اختياري، فبالتالي القيمة 0123.45e6‎+ هي قيمة عدديّة صالحة. لا يُسمَح باستخدام النظام الست عشري (مثل 0xf4c3b00c)، أو النظام الثنائي (مثل 0b10100111001).

المعاملات

var

القيمة المطلوب التّحقّق منها.

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

تُعيد القيمة TRUE إن كان المتغيّر عددًا أو سلسلة نصّيّة عدديّة، و FALSE فيما عدا ذلك.

أمثلة

المثال 1: أمثلة على الدالة is_numeric()‎

<?php
$tests = array(
    "42",
    1337,
    0x539,
    02471,
    0b10100111001,
    1337e0,
    "not numeric",
    array(),
    9.1,
    null
);

foreach ($tests as $element) {
    if (is_numeric($element)) {
        echo var_export($element, true) . " is numeric", PHP_EOL;
    } else {
        echo var_export($element, true) . " is NOT numeric", PHP_EOL;
    }
}
?>

ينتج عن المثال السّابق ما يلي:

'42' is numeric
1337 is numeric
1337 is numeric
1337 is numeric
1337 is numeric
1337 is numeric
'not numeric' is NOT numeric
array () is NOT numeric
9.0999999999999996447286321199499070644378662109375 is numeric
NULL is NOT numeric

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

الإصدار	الوصف
7.0.0	لم تعد تُعامَل السّلاسل النصّيّة ذات الصّيغة الست عشرية (0xf4c3b00c) على أنّها سلاسل نصّيّة عدديّة، أي أصبحت الدالة is_numeric()‎ تُعيد FALSE هنا.

انظر أيضًا

• الدالة ctype_digit()‎: التحقّق من المحارف العدديّة.
• الدالة is_bool()‎: معرفة إذا ما كان المتغيّر قيمةً منطقيةً (boolean).
• الدالة is_null()‎: معرفة إذا ما كان المتغيّر يحوي القيمة NULL.
• الدالة is_float()‎: معرفة إذا ما كان المتغيّر عددًا عشريًّا.
• الدالة is_int()‎: معرفة إذا ما كان المتغيّر عددًا صحيحًا.
• الدالة is_string()‎: معرفة إذا ما كان نوع المتغيّر سلسلة نصّيّة.
• الدالة is_object()‎: معرفة إذا ما كان المتغيّر كائنًا.
• الدالة is_array()‎: معرفة إذا ما كان المتغيّر مصفوفة.

مصادر

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