ARRAY_CHUNK |
Découper un tableau |
| PHP 4.2.0+ |
Syntaxe
|
function array_chunk($input,$size);
|
function array_chunk($input,$size,$preserve_keys);
|
Paramètres
| Nom |
Description |
| $input |
Ce paramètre permet d'indiquer le tableau à traiter |
| $size |
Ce paramètre permet d'indiquer la nouvelle taille de dimension de tableau |
| $preserve_keys |
Ce paramètre permet d'indiquer si la fonction doit préservé les clefs lors du redimensionnement : |
| TRUE |
Cette constante permet d'indiquer de conserver les clefs original du tableau. |
| FALSE |
Cette constante permet d'indiquer la création de nouvelles clefs. |
Retour
| Valeur |
Description |
| Tableau |
Ce type de données permet d'indiquer le tableau modifié selon le traitement demandé. |
Description
Cette fonction permet de changer le dimensionnement d'un tableau spécifié.
Remarques
- Utilité principale : La fonction array_chunk permet de diviser un tableau en plusieurs sous-tableaux d'une taille définie. C'est particulièrement utile
lorsqu'il est nécessaire de traiter des ensembles de données volumineux par morceaux, par exemple lors de la pagination ou d'opérations par lots.
- Taille des morceaux : Le deuxième paramètre de la fonction détermine la taille de chaque sous-tableau. Si la taille spécifiée est supérieure au nombre total
d'éléments du tableau, un seul sous-tableau contenant tous les éléments sera retourné.
- Conservation des clefs : Par défaut, les clés ne sont pas conservées dans les sous-tableaux, elles sont réinitialisées à des index numériques. Cependant, en
passant true comme troisième paramètre, il est possible de conserver les clefs d'origine dans chaque sous-tableau.
- Gestion des éléments restants : Si le tableau ne peut pas être divisé en morceaux de taille égale, le dernier sous-tableau contiendra les éléments restants. Cela
garantit que tous les éléments du tableau d'origine sont inclus dans le résultat final.
- Compatibilité avec les tableaux associatifs : Même avec des tableaux associatifs, la fonction fonctionne correctement. Si l'option de conservation des clefs est
activée, les associations clé-valeur restent intactes dans les sous-tableaux. Cela peut être utile pour des tableaux associatifs complexes.
- Impact sur la performance : Diviser un tableau en morceaux avec array_chunk est relativement rapide et efficace en termes de performances, même pour
de grands tableaux. Cependant, il convient de garder à l'esprit la mémoire nécessaire pour stocker les sous-tableaux résultants, en particulier si le tableau est volumineux.
- Applications pratiques : La fonction est couramment utilisée dans des cas comme le traitement par lots d'éléments (envoi de courriels, création de lots pour des
API), l'affichage par pages dans une interface utilisateur, ou encore pour gérer les limitations de mémoire dans des scripts manipulant de gros ensembles de données.
- Limitation : La fonction ne permet pas de spécifier un décalage ou de contrôler quels éléments vont dans quel sous-tableau. Si un contrôle plus précis est
nécessaire (par exemple, diviser par des critères spécifiques), une fonction personnalisée ou d'autres fonctions PHP comme array_slice peuvent être nécessaires.
Dernière mise à jour : Dimanche, le 22 mars 2015
