Функция wp_is_numeric_array() в WordPress предназначена для определения, является ли заданная переменная массивом, где все индексы — числовые. Это полезно, когда необходимо убедиться, что данные, с которыми вы работаете, имеют правильный формат.
wp_is_numeric_array( mixed $data ): bool
Параметры
- $data (mixed) — Переменная, которую нужно проверить. Предполагается, что это массив.
Возвращаемое значение
- true — если переданная переменная является массивом, и все ее индексы числовые.
- false — если это не массив или если хотя бы один индекс не является числом.
Описание работы функции
Функция проверяет, является ли переданная переменная массивом с любыми числовыми индексами. Однако она не проверяет, являются ли индексы последовательными. Например, массив с индексами [5, 10] будет считаться числовым, даже если индексы не начинаются с 0.
Пример 1: Проверка на массив с числовыми индексами
В этом примере мы демонстрируем, как использовать функцию wp_is_numeric_array() для различных типов данных:
// Пустой массив
var_dump(wp_is_numeric_array([])); // true
// Строка
var_dump(wp_is_numeric_array('foo')); // false
// Ассоциативный массив
var_dump(wp_is_numeric_array(['foo' => 'bar', 'foo2' => 'bar2'])); // false
// Массив с числовыми индексами
var_dump(wp_is_numeric_array(['foo', 'bar'])); // true
// Массив с не последовательными числовыми индексами
var_dump(wp_is_numeric_array([5 => 'foo', 10 => 'bar'])); // true
Пример 2: Проверка на индексный массив
Если вам необходимо проверить, является ли массив индексным (то есть его индексы идут по порядку от 0 до n), вы можете использовать вспомогательную функцию:
function is_indexed_array(array $data) {
return array_keys($data) === range(0, count($data) - 1);
}
var_dump(is_indexed_array(['foo', 'bar'])); // true
var_dump(is_indexed_array([5 => 'foo', 10 => 'bar'])); // false
В этом коде функция is_indexed_array() проверяет, соответствуют ли ключи массива диапазону от 0 до n, что говорит о том, что массив является индексным.
Заключение
Функция wp_is_numeric_array() предоставляет простой способ проверки, является ли переменная массивом с числовыми индексами в WordPress. Это особенно полезно при работе с данными, которые должны соответствовать определенному формату, и позволяет избежать ошибок при обработке массивов с нечисловыми индексами.