الفرق بين المراجعتين لصفحة: «PHP/gettype»

المراجعة الحالية بتاريخ 11:18، 16 أبريل 2018

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:الدالة <code>gettype()</code>‎ في PHP}}</noinclude>
+(PHP 4, PHP 5, PHP 7)
+تُعيد الدالة <code>gettype()‎‎‎‎</code> نوع المتغيّر.
+== الوصف ==
+<syntaxhighlight lang="php">
+string gettype ( mixed $var )
+</syntaxhighlight>تُعيد نوع المتغيّر <code>var</code> في PHP. للتحقّق من نوع المتغيّرات استخدم الدوال ذات البادئة <code>is_*‎</code>.
+== المعاملات ==
+=== <code>var</code> ===
+المتغيّر المطلوب التحقّق من نوعه.
+== القيم المعادة ==
+القيم الممكنة للسلسلة النصّيّة المُعادة هي:
+* <code>[[PHP/boolean|"boolean"]]</code>: قيمة منطقية.
+* <code>[[PHP/integer|"integer"]]</code>: عدد صحيح.
+* <code>"double"</code>: عدد مُضاعَف الدقة (لأسباب تاريخيّة تُعاد القيمة "double" في حال كان المتغيّر [[PHP/float|عددًا عشريًّا float]]، وذلك بدلًا من إعادة القيمة <code>"float"</code> ببساطة).
+* <code>[[PHP/Types/string|"string"]]</code>: سلسلة نصّيّة.
+* <code>[[PHP/array|"array"]]</code>: مصفوفة.
+* <code>[[PHP/object|"object"]]</code>: كائن.
+* <code>[[PHP/resource|"resource"]]</code>: مورد.
+* <code>resource (closed)"‎"</code>: مورد مغلق، بدءًا من إصدار PHP 7.2.0.
+* <code>[[PHP/null|"NULL"]]</code>: عَدَم.
+* <code>"unknown type"</code>: نوع غير معروف.
+== أمثلة ==
+المثال 1: مثال على الدالة <code>gettype()</code>‎‎‎<syntaxhighlight lang="php">
+<?php
+$data = array(1, 1., NULL, new stdClass, 'foo');
+foreach ($data as $value) {
+    echo gettype($value), "\n";
+}
+?>
+</syntaxhighlight>ينتج عن المثال السّابق ما يلي:<syntaxhighlight lang="text">
+integer
+double
+NULL
+object
+string
+</syntaxhighlight>
+== سجل التغييرات ==
+{| class="wikitable"
+!الإصدار
+!الوصف
+|-
+|7.2.0
+|يتم الإعلام عن نوع الموارد المغلقة باستخدام <code>resource (closed)'‎'</code>، حيث كانت القيمة المُعادة سابقًا في هذه الحالة هي نوع غير معروف <code>'unknown type'</code>.
+|}
+== انظر أيضًا ==
+* الدالة <code>[[PHP/settype|settype()‎]]</code>: تعيين نوع متغيّر ما.
+* الدالة <code>[[PHP/get class|get_class()‎‎]]</code>: إعادة اسم الصّنف لكائنٍ ما.
+* الدالة <code>[[PHP/is array|is_array()‎]]</code>: معرفة إذا ما كان المتغيّر مصفوفة.
+* الدالة <code>[[PHP/is bool|is_bool()‎]]</code>: معرفة إذا ما كان المتغيّر قيمةً منطقيةً (boolean).
+* الدالة <code>[[PHP/is callable|is_callable()‎]]</code>: التّحقّق من القدرة على استدعاء محتوى المتغيّر كدالة.
+* الدالة <code>[[PHP/is float|is_float()‎]]</code>: معرفة إذا ما كان المتغيّر عددًا عشريًّا.
+* الدالة <code>[[PHP/is int|is_int()‎]]</code>: معرفة إذا ما كان المتغيّر عددًا صحيحًا.
+* الدالة <code>[[PHP/is null|is_null()‎]]</code>: معرفة إذا ما كان المتغيّر يحوي القيمة NULL.
+* الدالة <code>[[PHP/is numeric|is_numeric()‎]]</code>: معرفة إذا ما كان المتغيّر عددًا أو سلسلة نصّيّة عدديّة.
+* الدالة <code>[[PHP/is object|is_object()‎]]</code>: معرفة إذا ما كان المتغيّر كائنًا.
+* الدالة <code>[[PHP/is resource|is_resource()‎]]</code>: معرفة إذا ما كان المتغيّر موردًا.
+* الدالة <code>[[PHP/is scalar|is_scalar()‎]]</code>: معرفة إذا ما كان المتغيّر أوليًا (scalar).
+* الدالة <code>[[PHP/is string|is_string()‎]]</code>: معرفة إذا ما كان نوع المتغيّر سلسلة نصّيّة.
+* الدالة <code>[[PHP/function exists|function_exists()‎]]</code>: إعادة <code>TRUE</code> إذا كانت الدالة المُعطاة مُعرَّفة مُسبقًا.
+* الدالة <code>[[PHP/method exists|method_exists()‎]]</code>: التّحقّق من وجود طريقة الصّنف.
+== مصادر ==
+* [http://php.net/manual/en/function.gettype.php صفحة الدالة gettype في توثيق PHP الرسمي].
+[[تصنيف:PHP]]
+[[تصنيف:PHP Function]]
+[[تصنيف:PHP Variable Handling]]