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

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

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

الوصف

bool is_scalar ( mixed $var )

تُحدِّد ما إذا كان المتغيّر المُعطى أوليًا.

المتغيّرات الأولية هي تلك التي تحتوي على عدد صحيح، أو عدد عشري، أو سلسلة نصّيّة، أو قيمة منطقيّة، أمّا الأنواع مصفوفة، وكائن، ومورد ليست قيمًا أولية.

ملاحظة: لا تُعامِل الدالة is_scalar()‎ القيم من نوع مورد على أنّها قيم أولية، إذ إنّ الموارد هي نوع بيانات مُجرَّد مُعتمِد حاليًّا على الأعداد الصّحيحة، ولكن لا ينبغي الاعتماد على هذا لأنّه قد يتغيّر. لا تُعامِل هذه الدالة أيضًا القيمة NULL على أنّها قيمة أولية.

المعاملات

var

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

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

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

أمثلة

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

<?php
function show_var($var) 
{
    if (is_scalar($var)) {
        echo $var;
    } else {
        var_dump($var);
    }
}
$pi = 3.1416;
$proteins = array("hemoglobin", "cytochrome c oxidase", "ferredoxin");

show_var($pi);
show_var($proteins)

?>

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

3.1416
array(3) {
  [0]=>
  string(10) "hemoglobin"
  [1]=>
  string(20) "cytochrome c oxidase"
  [2]=>
  string(10) "ferredoxin"
}

انظر أيضًا

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

مصادر

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