ARRAY_CHANGE_KEY_CASE |
Change les casses des clefs d'un tableau |
PHP 4.2.0+ |
Syntaxe
function array_change_key_case($input);
|
function array_change_key_case($input,$case);
|
Paramètres
Nom |
Description |
$input |
Ce paramètre permet d'indiquer le tableau à traiter |
$case |
Ce paramètre permet d'indiquer le type de traitement demandé : |
CASE_UPPER |
Cette constante permet d'indiquer de convertir en majuscule toutes les chaînes de caractères du tableau. |
CASE_LOWER |
Cette constante permet d'indiquer de convertir en minuscule toutes les chaînes de caractères du tableau. Cette constante est utilisé par défaut. |
Retour
Valeur |
Description |
Tableau |
Ce type de données permet d'indiquer le tableau modifié selon le traitement demandé. |
Description
Cette fonction permet de convertir en minuscule ou majuscule les éléments d'un tableau spécifié.
Remarques
- Utilité principale : La fonction array_change_key_case est utile pour harmoniser la casse des clefs d'un tableau associatif. Cela peut être
particulièrement pratique lorsque les données proviennent de sources externes (fichiers, bases de données, API) qui peuvent mélanger des majuscules et des minuscules dans les
noms de clefs.
- Sensibilité à la casse : Par défaut, la fonction convertit toutes les clefs du tableau en minuscules (CASE_LOWER). Toutefois, il est possible de spécifier
une conversion en majuscules (CASE_UPPER) grâce au deuxième paramètre optionnel, offrant ainsi une flexibilité selon les besoins.
- Impact sur les valeurs : La fonction ne modifie que les clefs du tableau, sans affecter les valeurs associées. Cela en fait une solution ciblée lorsque seul le
format des clés nécessite un traitement spécifique. Les valeurs, qu'elles soient des chaînes, des entiers ou des sous-tableaux, restent inchangées.
- Compatibilité avec les sous-tableaux : Si le tableau contient des sous-tableaux (tableaux imbriqués), seuls les niveaux supérieurs des clefs seront modifiés. Les
clefs des sous-tableaux ne sont pas affectées, sauf si la fonction est appelée de manière récursive (en utilisant une boucle manuelle ou une fonction personnalisée).
- Effets sur les clés numériques : Les clefs numériques d'un tableau ne sont pas modifiées par cette fonction. Cela peut être utile pour conserver l'intégrité d'un
tableau mixte (associatif et indexé) tout en uniformisant uniquement les clefs textuelles.
- Compatibilité des versions PHP : La fonction est disponible depuis PHP 4.2.0, ce qui garantit une large compatibilité avec les versions modernes et anciennes
de PHP. Elle peut donc être utilisée dans des projets nécessitant le support de versions plus anciennes.
- Comportement avec des clefs dupliquées : Si deux clefs distinctes d'un tableau deviennent identiques après la conversion (par exemple, ["Key" => 1, "KEY" => 2]),
la dernière clef écrasera les précédentes. Cela peut entraîner une perte de données si une vérification préalable n'est pas effectuée.
- Alternatives ou approches personnalisées : Bien que array_change_key_case soit pratique, elle peut être combinée avec d'autres fonctions PHP, comme
array_map ou array_walk, pour des transformations plus complexes ou adaptées aux cas spécifiques, comme la gestion récursive ou des transformations conditionnelles
des clefs.
Dernière mise à jour : Dimanche, le 22 mars 2015