PHP.mk документација

array_find

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

function.array-find.php PHP.net прокси Преводот е вчитан
Оригинал на PHP.net
Патека function.array-find.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + преведен приказ Кодовите, табелите и белешките остануваат читливи во истиот тек.
array_find

Референца за `function.array-find.php` со подобрена типографија и навигација.

function.array-find.php

array_find

Класата Dom\DtdNamedNodeMap

array_findВраќа прв елемент што задоволува callback функција

= NULL

array_find(array $array, callable $callback): mixed

array_find() враќа вредност на првиот елемент од array за кој даден callback returns true. Ако не се најде соодветен елемент, функцијата враќа null.

Параметри

array
На array што треба да се пребарува.
callback

Callback функцијата што треба да се повика за проверка на секој елемент, која мора да биде

callback(mixed $value, mixed $key): bool
Ако оваа функција враќа true, вредноста се враќа од array_find() и callback нема да биде повикан за понатамошни елементи.

Вратени вредности

Функцијата враќа вредност на првиот елемент за кој callback returns true. Ако не се најде соодветен елемент, функцијата враќа null.

Примери

Пример #1 array_find() example

<?php
$array
= [
'a' => 'dog',
'b' => 'cat',
'c' => 'cow',
'd' => 'duck',
'e' => 'goose',
'f' => 'elephant'
];

// Find the first animal with a name longer than 4 characters.
var_dump(array_find($array, function (string $value) {
return
strlen($value) > 4;
}));

// Find the first animal whose name begins with f.
var_dump(array_find($array, function (string $value) {
return
str_starts_with($value, 'f');
}));

// Find the first animal where the array key is the first symbol of the animal.
var_dump(array_find($array, function (string $value, $key) {
return
$value[0] === $key;
}));

// Find the first animal where the array key matching a RegEx.
var_dump(array_find($array, function ($value, $key) {
return
preg_match('/^([a-f])$/', $key);
}));
?>

Пример #1 Пример што покажува затворачка ознака што го опфаќа последниот нов ред

string(5) "goose"
NULL
string(3) "cow"
string(3) "dog"

Види Исто така

  • array_find_key() - Враќа клуч на првиот елемент што задоволува callback функција
  • array_all() - Проверува дали сите елементи на низата задоволуваат callback функција
  • array_any() - Проверува дали барем еден елемент од низата задоволува функција за враќање
  • array_filter() - Филтрира елементи од низа користејќи функција за повикување
  • array_reduce() - Итеративно намалувајте ја низата до една вредност користејќи функција за повикување

Белешки од корисници 2 забелешки

mail на nititech dot de
11 месеци пред
A simple fallback For older PHP versions, that do not have array_find:

<?php

/**
 * Porting of PHP 8.4 function
 *
 * @template TValue of mixed
 * @template TKey of array-key
 *
 * @param array<TKey, TValue> $array
 * @param callable(TValue $value, TKey $key): bool $callback
 * @return ?TValue
 *
 * @see https://www.php.net/manual/en/function.array-find.php
 */
function array_find(array $array, callable $callback): mixed
{
    foreach ($array as $key => $value) {
        if ($callback($value, $key)) {
            return $value;
        }
    }

    return null;
}
?>
harl на gmail точка ком
empiredesrtroyer12 at gmail dot com
Note that if null satisfies the callback then there is no way to tell if null was returned because it was found in the array or if it was because nothing satisfying the callback was found.

In this case, it'll be more robust to use array_find_key; null can't be a key, so if that's what you get it must be because the search failed to find a match.

Obviously, you'd then use the array key to look up the corresponding value in the array.
На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.