A slight correction to brcontainer's polyfill, which prevents errors on a non-object in a non-blocking way, and also corrects the issue of the conditional checking "file_exists" instead of the correct "function_exists":
if ( !function_exists( 'is_iterable' ) )
{
function is_iterable( $obj )
{
return is_array( $obj ) || ( is_object( $obj ) && ( $obj instanceof \Traversable ) );
}
}
The original answer would not have resolved correctly, because it was looking for a file instead of a function, and the provided method would error if given a non-iterable non-object value such as false.
is_iterable
(PHP 7 >= 7.1.0, PHP 8)
is_iterable — Verify that the contents of a variable is an iterable value
Description
Verify that the contents of a variable is accepted by the iterable pseudo-type, i.e. that it is either an array or an object implementing Traversable
Parameters
-
value -
The value to check
Return Values
Returns true if value is iterable, false
otherwise.
Examples
Example #1 is_iterable() examples
<?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)
?>
add a note
User Contributed Notes 4 notes
mopsyd at me dot com ¶
6 years ago
info at ensostudio dot ru ¶
3 years ago
Note: IteratorAggregate too extends Traversable:
<?php
class Data implements IteratorAggregate
{
protected $data = ['foo' => 'bar'];
public function getIterator(): Generator
{
return yield from $this->data;
}
}
var_dump(is_iterable(new Data())); // bool(true)
?>
anatoly dot pashin at gmail dot com ¶
6 years ago
Here is more details on iterable type: http://php.net/manual/en/language.types.iterable.php
brcontainer at yahoo dot com dot br ¶
6 years ago
Polyfill for PHP5.6 and PHP7.0
if (!file_exists('is_iterable')) {
function is_iterable($obj)
{
return is_array($obj) || $obj instanceof \Traversable;
}
}
