ARRAY_PAD |
Tableau : Rembourer |
| PHP 4.0+ |
Syntaxe
|
function array_pad($input,$pad_size,$pad_value);
|
Paramètres
| Nom |
Description |
| $input |
Ce paramètre permet d'indiquer le tableau à traiter avec des valeurs initiales. |
| $pad_size |
Ce paramètre permet d'indiquer le nombre de cellule que doit avoir le tableau. |
| $pad_value |
Ce paramètre permet d'indiquer la valeur des cellules devant être créer pour obtenir la longueur indiqué. |
Retour
| Valeur |
Description |
| tableau |
Ces valeurs permettent d'indiquer un tableau d'au moins la longueur indiqué. |
Description
Cette fonction permet de créer des cellules supplémentaires de façon à obtenir le même nombre de cellule que celui indiqué sur un tableau existant.
Remarques
- Ajout d'éléments à un tableau : La fonction array_pad() permet d'ajouter des éléments à un tableau jusqu'à une longueur spécifiée. Si le tableau est plus
court que la longueur souhaitée, des valeurs sont ajoutées. Cela est utile pour compléter des tableaux ou garantir qu'un tableau atteint une taille spécifique.
- Insertion d'éléments à la fin ou au début : array_pad() permet d'ajouter des éléments à la fin du tableau (par défaut) ou au début si la longueur cible est
plus petite que la taille initiale du tableau. Ce comportement est contrôlé en spécifiant une valeur négative pour la longueur du tableau, ce qui permet un "padding" à gauche.
- Valeur par défaut pour les éléments ajoutés : Si la taille cible du tableau est plus grande que la taille actuelle, les éléments ajoutés sont remplis avec une
valeur spécifiée. Cette valeur peut être une chaîne de caractères, un entier ou même un autre tableau, ce qui permet une grande flexibilité dans la façon dont les éléments sont
ajoutés.
- Maintien des clefs existantes : Lors de l'ajout d'éléments à un tableau, les clefs des éléments existants ne sont pas modifiées. Si des éléments sont ajoutés à la fin
ou au début, ils recevront des clefs numériques successives ou indexées, selon la structure du tableau d'origine.
- Nécessité d'une longueur de tableau spécifique : Il est important de noter que array_pad() ne modifie le tableau que si sa taille est insuffisante. Si la
taille initiale est déjà égale ou supérieure à la longueur cible, la fonction retourne simplement le tableau d'origine sans modification.
- Manipulation de tableaux multidimensionnels : array_pad() peut être utilisée avec des tableaux multidimensionnels, mais l'ajout d'éléments ne se fait que sur
le premier niveau du tableau. Pour manipuler des sous-tableaux de manière spécifique, il faudrait utiliser des approches supplémentaires comme une boucle ou une fonction récursive.
- Performances et utilisation avec des tableaux volumineux : Lorsqu'il est utilisé sur des tableaux très volumineux, array_pad() peut affecter les performances, car
la fonction crée une copie du tableau modifié. Il est donc préférable d'utiliser cette fonction judicieusement dans des contextes où la taille du tableau est gérable.
- Utilisation dans des cas de remplissage conditionnel : array_pad() est utile pour les situations où il est nécessaire de remplir des tableaux à une taille définie, comme
dans les cas de préparation de données pour des formats de sortie comme JSON, ou de gestion de matrices où chaque ligne doit avoir
une longueur égale.
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 362
Dernière mise à jour : Dimanche, le 22 mars 2015
