array_all

(PHP 8 >= 8.4.0)

array_all — Verifica se todos os elementos de um array satisfazem uma função de retorno

Descrição

array_all(array $array, callable $callback): bool

array_all() retorna true, se a função de retorno callback retornar true para todos os elementos. Caso contrário, retorna false.

Parâmetros

array

O array a ser pesquisado.

callback

A função de retorno a ser chamada para verificar cada elemento, que precisa ter a seguinte assinatura:

callback(mixed $value, mixed $key): bool

Se esta função retornar false, false é retornado por array_all() e a função de retorno não será chamada para os elementos restantes.

Valor Retornado

A função retorna true, se callback retornar true para todos os elementos. Caso contrário retorna false.

Exemplos

Exemplo #1 Exemplo de array_all()

<?php
$array = [
    'a' => 'cachorro',
    'b' => 'gato',
    'c' => 'vaca',
    'd' => 'pato',
    'e' => 'elefante',
    'f' => 'ganso'
];

// Verifica se todos os nomes de animais têm menos de 12 letras.
var_dump(array_all($array, function (string $value) {
    return strlen($value) < 12;
}));

// Verifica se todos os nomes de animais têm mais que 5 letras.
var_dump(array_all($array, function (string $value) {
    return strlen($value) > 5;
}));

// Verifica se todas as chaves são strings.
var_dump(array_all($array, function (string $value, $key) {
   return is_string($key);
}));
?>

O exemplo acima produzirá:

bool(true)
bool(false)
bool(true)

Veja Também

array_any() - Verifica se pelo menos um elemento de um array satisfaz uma função de retorno
array_filter() - Filtra elementos de um array utilizando uma função callback
array_find() - Retorna um primeiro elemento que satisfaz uma função de retorno
array_find_key() - Retorna a chave do primeiro elemento que satisfaz uma função de retorno