الدالة 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 الرسمي.