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

من موسوعة حسوب
< 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()‎: التّحقّق من وجود طريقة الصّنف.

مصادر