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

(PHP 7 >= 7.1.0)

تتحقّق الدالة is_iterable()‎‎ من أنّ محتوى المتغيّر هو قيمة تكراريّة (iterable).

الوصف

bool is_iterable ( mixed $var )

تتحقّق من أنّ محتوى المتغيّر مقبول بواسطة النّوع الزائف التكراري (iterable pseudo-type)، أي أنّه مصفوفة أو كائن يستخدم الواجهة Traversable.

المعاملات

var

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

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

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

أمثلة

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

<?php

var_dump(is_iterable([1, 2, 3]));  // bool(true)
var_dump(is_iterable(new ArrayIterator([1, 2, 3])));  // bool(true)
var_dump(is_iterable((function () { yield 1; })()));  // bool(true)
var_dump(is_iterable(1));  // bool(false)
var_dump(is_iterable(new stdClass()));  // bool(false)

?>

انظر أيضًا

• الدالة is_array()‎: معرفة إذا ما كان المتغيّر مصفوفة.

مصادر

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