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

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    45
    info at arisendrake dot de
    6 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
    3
    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
    2
    danmichaelo at gmail dot com
    5 years ago
    Note that a polyfill for this method is also provided by the symfony/polyfill project.
    ＋add a note
    To Top