PHP 8.6.0 Released!

array_find_key

(PHP 8 >= 8.4.0)

array_find_key — Restituisce la chiave del primo elemento che soddisfa una funzione callback

Descrizione

function array_find_key(array $array, callable $callback): mixed

array_find_key() restituisce la chiave del primo elemento di un array per il quale la callback fornita restituisce true. Se non viene trovato alcun elemento corrispondente la funzione restituisce null.

Elenco dei parametri

array

L'array in cui effettuare la ricerca.

callback

La funzione callback da richiamare per verificare ogni elemento, che deve avere la seguente firma:

function callback(mixed $value, mixed $key): bool
Se questa funzione restituisce true, la chiave viene restituita da array_find_key() e la callback non viene richiamata per gli elementi successivi.

Valori restituiti

La funzione restituisce la chiave del primo elemento per il quale callback restituisce true. Se non viene trovato alcun elemento corrispondente la funzione restituisce null.

Esempi

Example #1 Esempio di array_find_key()

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

// Trova il primo animale con un nome più lungo di 4 caratteri.
var_dump(array_find_key($array, function (string $value) {
    return strlen($value) > 4;
}));

// Trova il primo animale il cui nome inizia con f.
var_dump(array_find_key($array, function (string $value) {
    return str_starts_with($value, 'f');
}));

// Trova il primo animale la cui chiave dell'array è la prima lettera dell'animale.
var_dump(array_find_key($array, function (string $value, $key) {
   return $value[0] === $key;
}));

// Trova il primo animale la cui chiave dell'array corrisponde a un'espressione regolare.
var_dump(array_find_key($array, function ($value, $key) {
   return preg_match('/^([a-f])$/', $key);
}));
?>

Il precedente esempio visualizzerà:

string(1) "e"
NULL
string(1) "c"
string(1) "a"

Vedere anche:

  • array_find() - Restituisce il primo elemento che soddisfa una funzione callback
  • array_all() - Verifica se tutti gli elementi di un array soddisfano una funzione callback
  • array_any() - Verifica se almeno un elemento di un array soddisfa una funzione callback
  • array_filter() - Filtra gli elementi di un array usando una funzione callback
  • array_reduce() - Riduce iterativamente l'array a un singolo valore usando una funzione callback
+add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top