array_find()WP 6.8.0

Находит первое значение массива, соответствующее указанному условию.

Полифил функции array_find() добавленной в PHP 8.4.

Передаёт callback-функции значение и ключ каждого элемента. Поиск прекращается после первого результата true.

Хуков нет.

Возвращает

Разное|null.

  • mixed - первое значение, прошедшее проверку.
  • null - подходящее значение не найдено, массив пуст или найденное значение равно null.

Использование

array_find( $array, $callback );
$array(array) (обязательный)
Массив для поиска.
$callback(callable) (обязательный)
Функция проверки вида callback( $value, $key ): bool, где $value - значение элемента, $key - его ключ.

Примеры

0

#1 Поиск первого подходящего значения

Найдём первое число больше 10.

$numbers = [ 4, 15, 8, 23 ];

$number = array_find(
	$numbers,
	static function ( $value ) {
		return $value > 10;
	}
);

var_dump( $number ); // int(15)

Список изменений

С версии 6.8.0 Введена.

Код array_find() WP 7.0.2

function array_find( array $array, callable $callback ) { // phpcs:ignore Universal.NamingConventions.NoReservedKeywordParameterNames.arrayFound
	foreach ( $array as $key => $value ) {
		if ( $callback( $value, $key ) ) {
			return $value;
		}
	}

	return null;
}