SaferPluginArrayHelpers

La classe SaferPluginArrayHelpers fournit des méthodes d'aide pour travailler avec des tableaux.

Méthodes

keepOnly(array $array, array $keys): array

public static function keepOnly(array $array, array $keys): array

Description

Filtre un tableau pour ne conserver que les clés spécifiées.

Paramètres

  • array $array : Le tableau d'entrée.
  • array $keys : Les clés à conserver. Peut être un tableau associatif où les clés sont les noms d'origine et les valeurs sont des alias.

Retour

  • array : Le tableau filtré.

Exemple

$array = ['a' => 1, 'b' => 2, 'c' => 3];
$filtered = SaferPluginArrayHelpers::keepOnly($array, ['a', 'b' => 'b_alias']);
// Résultat : ['a' => 1, 'b_alias' => 2]

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

public static function every(array $array, callable $callback): bool

Description

Vérifie si une fonction de rappel retourne vrai pour chaque élément d'un tableau.

Paramètres

  • array $array : Le tableau d'entrée.
  • callable $callback : La fonction de rappel à appliquer à chaque élément. La fonction de rappel reçoit trois arguments : la valeur, la clé, et le tableau.

Retour

  • bool : true si la fonction de rappel retourne vrai pour chaque élément, false sinon.

Exemple

$array = [2, 4, 6];
$result = SaferPluginArrayHelpers::every($array, fn($v) => $v % 2 === 0);
// Résultat : true

isAssoc(array $array, bool $emptyIsAssoc = false): bool

public static function isAssoc(array $array, bool $emptyIsAssoc = false): bool

Description

Vérifie si un tableau est associatif.

Paramètres

  • array $array : Le tableau à vérifier.
  • bool $emptyIsAssoc (optionnel) : Indique si un tableau vide doit être considéré comme associatif. Par défaut à false.

Retour

  • bool : true si le tableau est associatif, false sinon.

Exemple

$array1 = ['a' => 1, 'b' => 2];
$array2 = [1, 2, 3];
$isAssoc1 = SaferPluginArrayHelpers::isAssoc($array1);
// Résultat : true
$isAssoc2 = SaferPluginArrayHelpers::isAssoc($array2);
// Résultat : false

mapAssoc(callable $callback, array $arr): array

public static function mapAssoc(callable $callback, array $arr): array

Description

Applique une fonction de rappel à chaque élément d'un tableau et retourne un nouveau tableau avec les résultats.

Paramètres

  • callable $callback : La fonction de rappel à appliquer à chaque élément. La fonction de rappel reçoit trois arguments : la valeur, la clé, et le tableau.
  • array $arr : Le tableau d'entrée.

Retour

  • array : Le tableau résultant après application de la fonction de rappel.

Exemple

$array = ['a' => 1, 'b' => 2];
$result = SaferPluginArrayHelpers::mapAssoc(fn($v) => $v * 2, $array);
// Résultat : ['a' => 2, 'b' => 4]

reduceAssoc(callable $callback, array $arr, $initial = []): mixed

public static function reduceAssoc(callable $callback, array $arr, $initial = [])

Description

Réduit un tableau à une seule valeur en appliquant une fonction de rappel à chaque élément.

Paramètres

  • callable $callback : La fonction de rappel à appliquer à chaque élément. La fonction de rappel reçoit quatre arguments : l'accumulateur, la valeur, la clé, et le tableau.
  • array $arr : Le tableau d'entrée.
  • mixed $initial (optionnel) : La valeur initiale pour l'accumulateur.

Retour

  • mixed : La valeur réduite.

Exemple

$array = [1, 2, 3];
$result = SaferPluginArrayHelpers::reduceAssoc(fn($acc, $v) => $acc + $v, $array, 0);
// Résultat : 6