Функция is_countable() в PHP 7.3: синтаксис и примеры использования

# Функция IS_COUNTABLE() │ WP 4.9.6

Функция is_countable() была добавлена в PHP 7.3 и используется для проверки, является ли содержимое переменной массивом или объектом, который реализует интерфейс Countable.

### Быстрая информация

- **Время выполнения**: 1 раз — 0.000001 сек (световая скорость) | 50000 раз — 0.01 сек (световая скорость)
- **PHP версия**: 7.1.11, WP 4.9.8
- **Хуки**: Не используются.

### Результат

Функция возвращает true или false. Она возвращает true, если переменная $value является счетным значением, и false в противном случае.

### Синтаксис

```php
is_countable( $value );

• $value (mixed) (обязательный) — значение, которое нужно проверить.

Примеры использования

Давайте посмотрим на несколько примеров, чтобы понять, как работает is_countable().

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)

Пояснения к примерам

• В первом примере мы передаем массив [1, 2, 3], и функция возвращает true, так как массив является счетным значением.
• Во втором примере мы используем ArrayIterator, который тоже является счетным, поэтому результат true.
• В третьем примере ArrayIterator без элементов все равно считается счетным, результат снова true.
• В четвертом примере мы передаем объект stdClass, и результат false, так как объект не реализует интерфейс Countable.

Изменения в функции

• С версии 4.9.6: функция была введена.

Код функции IS_COUNTABLE

Вот как выглядит код функции is_countable в WordPress:

function is_countable( $value ) {
    return ( is_array( $value )
        || $value instanceof Countable
        || $value instanceof SimpleXMLElement
        || $value instanceof ResourceBundle
    );
}

Связанные функции

Хотя is_countable() используется редко, существуют и другие функции, которые могут вам понадобиться:

• bool_from_yn()
• remove_accents()
• translate()

Полезные функции Пари (PHP Polyfills)

Если вы ищете аналогичные функции, вот несколько из них:

• array_is_list()
• array_key_first()
• array_key_last()
• is_iterable()
• str_contains()
• str_ends_with()
• str_starts_with()
• wp_basename()
• wp_filesize()
• wp_generate_uuid4()
• wp_json_encode()
• wp_mkdir_p()
• wp_parse_str()
• wp_rand()
• wp_sprintf()

Эта статья охватывает основы функции is_countable(), объясняя её использование простым языком, чтобы даже начинающие пользователи WordPress могли легко её понять.