функция
since 3.1.0
wp_list_pluck()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_list_pluck( array $input_list, int|string $field, int|string $index_key = null ): arrayОписание
Обладает той же функциональностью и сигнатурой, что и array_column() (PHP 5.5), но также поддерживает объекты.
Оригинал (английский)
This has the same functionality and prototype of array_column() (PHP 5.5) but also supports objects.
Параметры
$input_list
array
обязательный
Список объектов или массивов.
$field
int|string
обязательный
Поле объекта, которое подставляется вместо всего объекта.
$index_key
int|string
необязательный
= null
Поле объекта, которое используется в качестве ключей нового массива.
Возвращаемое значение
array
$index_key $index_key $index_key $input_list
Исходный код
wp-includes/functions.php:5395
function wp_list_pluck( $input_list, $field, $index_key = null ) {
if ( ! is_array( $input_list ) ) {
return array();
}
$util = new WP_List_Util( $input_list );
return $util->pluck( $field, $index_key );
}История изменений
| Версия | Описание |
|---|---|
| 4.7.0 | Uses WP_List_Util class. |
| 4.0.0 | $index_key parameter added. |
| 3.1.0 | Introduced. |
