الدالة `gettype()`‎ في PHP

(PHP 4, PHP 5, PHP 7)

تُعيد الدالة gettype()‎‎‎‎ نوع المتغيّر.

الوصف

string gettype ( mixed $var )

تُعيد نوع المتغيّر var في PHP. للتحقّق من نوع المتغيّرات استخدم الدوال ذات البادئة is_*‎.

المعاملات

`var`

المتغيّر المطلوب التحقّق من نوعه.

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

القيم الممكنة للسلسلة النصّيّة المُعادة هي:

"boolean": قيمة منطقية.
"integer": عدد صحيح.
"double": عدد مُضاعَف الدقة (لأسباب تاريخيّة تُعاد القيمة "double" في حال كان المتغيّر عددًا عشريًّا float، وذلك بدلًا من إعادة القيمة "float" ببساطة).
"string": سلسلة نصّيّة.
"array": مصفوفة.
"object": كائن.
"resource": مورد.
resource (closed)"‎": مورد مغلق، بدءًا من إصدار PHP 7.2.0.
"NULL": عَدَم.
"unknown type": نوع غير معروف.

أمثلة

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

<?php

$data = array(1, 1., NULL, new stdClass, 'foo');

foreach ($data as $value) {
    echo gettype($value), "\n";
}

?>

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

integer
double
NULL
object
string

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

الإصدار	الوصف
7.2.0	يتم الإعلام عن نوع الموارد المغلقة باستخدام `resource (closed)'‎'`، حيث كانت القيمة المُعادة سابقًا في هذه الحالة هي نوع غير معروف `'unknown type'`.

انظر أيضًا

الدالة settype()‎: تعيين نوع متغيّر ما.
الدالة get_class()‎‎: إعادة اسم الصّنف لكائنٍ ما.
الدالة is_array()‎: معرفة إذا ما كان المتغيّر مصفوفة.
الدالة is_bool()‎: معرفة إذا ما كان المتغيّر قيمةً منطقيةً (boolean).
الدالة is_callable()‎: التّحقّق من القدرة على استدعاء محتوى المتغيّر كدالة.
الدالة is_float()‎: معرفة إذا ما كان المتغيّر عددًا عشريًّا.
الدالة is_int()‎: معرفة إذا ما كان المتغيّر عددًا صحيحًا.
الدالة is_null()‎: معرفة إذا ما كان المتغيّر يحوي القيمة NULL.
الدالة is_numeric()‎: معرفة إذا ما كان المتغيّر عددًا أو سلسلة نصّيّة عدديّة.
الدالة is_object()‎: معرفة إذا ما كان المتغيّر كائنًا.
الدالة is_resource()‎: معرفة إذا ما كان المتغيّر موردًا.
الدالة is_scalar()‎: معرفة إذا ما كان المتغيّر أوليًا (scalar).
الدالة is_string()‎: معرفة إذا ما كان نوع المتغيّر سلسلة نصّيّة.
الدالة function_exists()‎: إعادة TRUE إذا كانت الدالة المُعطاة مُعرَّفة مُسبقًا.
الدالة method_exists()‎: التّحقّق من وجود طريقة الصّنف.

مصادر

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