is_countable

(PHP 7 >= 7.3.0, PHP 8)

is_countable Verify that the contents of a variable is a countable value

Description

is_countable(mixed $value): bool

Verify that the contents of a variable is an array or an object implementing Countable

Parameters

value

The value to check

Return Values

Returns true if value is countable, false otherwise.

Changelog

Version Description
7.3.0 is_countable() has been added.

Examples

Example #1 is_countable() examples

<?php
var_dump
(is_countable([1, 2, 3])); // bool(true)
var_dump(is_countable(new ArrayIterator(['foo', 'bar', 'baz']))); // bool(true)
var_dump(is_countable(new ArrayIterator())); // bool(true)
var_dump(is_countable(new stdClass())); // bool(false)

See Also

  • is_array() - Finds whether a variable is an array
  • is_object() - Finds whether a variable is an object
  • is_iterable() - Verify that the contents of a variable is an iterable value
  • is_bool() - Finds out whether a variable is a boolean
add a note

User Contributed Notes 3 notes

up
46
info at arisendrake dot de
5 years ago
If you are unable to upgrade to PHP 7.3 (not released at the time of writing), you can use this simple polyfill:

<?php
if (!function_exists('is_countable')) {
function
is_countable($var) {
return (
is_array($var) || $var instanceof Countable);
}
}
?>
up
2
renic
5 years ago
be wary of using is_object($var) and assuming that the object has implemented Countable. Not all objects are countable directly with count().
up
1
danmichaelo at gmail dot com
5 years ago
Note that a polyfill for this method is also provided by the symfony/polyfill project.
To Top