array_find

(PHP 8 >= 8.4.0)

array_find — Bir geriçağırım işlevini sağlayan ilk elemanı döndürür

Açıklama

array_find(array $dizi, callable $işlev): mixed

array_find(), belirtilen işlev geriçağırım işlevinin true döndürdüğü dizi dizisinin ilk elemanının değerini döndürür. Eşleşen bir eleman bulunamazsa işlev null döndürür.

Bağımsız Değişkenler

dizi

Aranacak array.

işlev

Her elemanı denetlemek için çağrılacak geriçağırım işlevi. Aşağıdaki biçimde olmalıdır:

işlev(mixed $değer, mixed $anahtar): bool

Bu işlev true dönerse, değer array_find() tarafından döndürülür ve geriçağırım sonraki elemanlar için artık çağrılmaz.

Dönen Değerler

işlev geriçağırım işlevinin true döndürdüğü ilk elemanın değerini döndürür. Eşleşen bir eleman bulunamazsa işlev null döndürür.

Örnekler

Örnek 1 array_find() örneği

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

// İsmi 4 karakterden uzun ilk hayvanı bulur.
var_dump(array_find($array, function (string $value) {
    return strlen($value) > 4;
}));

// İsmi f ile başlayan ilk hayvanı bulur.
var_dump(array_find($array, function (string $value) {
    return str_starts_with($value, 'f');
}));

// Anahtarın hayvan isminin ilk harfi olduğu ilk hayvanı bulur.
var_dump(array_find($array, function (string $value, $key) {
   return $value[0] === $key;
}));

// Anahtarı bir düzenli ifadeyle eşleşen ilk hayvanı bulur.
var_dump(array_find($array, function ($value, $key) {
   return preg_match('/^([a-f])$/', $key);
}));
?>

Yukarıdaki örneğin çıktısı:

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

Ayrıca Bakınız

array_find_key() - Bir geriçağırım işlevini sağlayan ilk elemanın anahtarını döndürür
array_all() - Bir array elemanlarının tümünün bir geriçağırım işlevini sağlayıp sağlamadığını sınar
array_any() - Bir array elemanlarından en az birinin bir geriçağırım işlevini sağlayıp sağlamadığını sınar
array_filter() - Bir dizinin elemanlarını bir geriçağırım işleviyle süzgeçten geçirir
array_reduce() - Bir geriçağırım işlevini dizinin bütün elemanlarına tek tek uygulayıp sonucu döndürür