ARRAY_PUSH |
Empiler au tableau |
|---|---|
| PHP 4+ | |
Syntaxe
| function array_push(&$array, $var); |
| function array_push(&$array, $var,...); |
Paramètres
| Nom | Description |
|---|---|
| $array | Ce paramètre permet d'indiquer le tableau à traiter |
| $var | Ce paramètre permet d'indiquer les valeurs à ajouter au tableau |
Retour
| Valeur | Description |
|---|---|
| entier | Ces valeurs permettent d'indiquer le nombre d'éléments dans le tableau. |
Description
Cette fonction permet d'ajouter des éléments à la fin d'un tableau.
Remarques
- Comportement array_push vs brackets : Si vous utilisez la syntaxe «$tableau[] = valeur;» plutôt qu'une fonction array_push, sachez que la fonction «array_push» renvoie un message d'erreur si la variable n'est pas un tableau. Donc, pour cette raison, il est plus sécuritaire d'utiliser la fonction «array_push» car il est moins permissif.
- Performance array_push vs brackets : Si vous cherchez à augmenter la performance de votre code source PHP, dans un contexte normal, la syntaxe «$tableau[] = valeur;» est plus rapide qu'une fonction «array_push», cependant, les rôles sont inversés dans le cas de plusieurs valeurs par itération.
- array_push key + value : La fonction array_push ne permet d'ajouter une clef et une valeur, vous devriez utiliser «$array[$key] = $value;» plutôt que «array_push($array,$key => $value);».
- Ajout d'éléments à la fin d'un tableau : La fonction array_push() permet d'ajouter un ou plusieurs éléments à la fin d'un tableau. Elle est pratique pour ajouter des éléments dans un tableau dynamique ou pour construire une collection à partir de valeurs successives. Elle modifie directement le tableau passé en paramètre.
- Retourne la nouvelle taille du tableau : Contrairement à d'autres fonctions ne retournant rien, array_push() retourne la nouvelle taille du tableau après l'ajout des éléments. Cela peut être utile si vous souhaitez savoir combien d'éléments le tableau contient après l'ajout.
- Prend plusieurs éléments en entrée : array_push() peut prendre un ou plusieurs éléments à ajouter au tableau. Si plusieurs éléments sont fournis, ils seront ajoutés dans l'ordre où ils apparaissent dans les paramètres. Cela permet de pousser plusieurs éléments à la fois sans avoir besoin de les ajouter un par un.
- Modification directe du tableau : La fonction modifie directement le tableau passé par référence. Cela signifie qu'il n'est pas nécessaire de récupérer une valeur retournée pour voir l'effet de l'ajout d'éléments. Le tableau original est modifié en place, ce qui peut être plus efficace dans certains cas.
- Comportement avec des tableaux associatifs : Lorsque array_push() est utilisé avec un tableau associatif, la fonction ajoute les éléments avec des clefs numériques de manière continue. Les clés associatives des éléments existants ne sont pas préservées, et de nouveaux indices numériques sont attribués aux nouveaux éléments ajoutés.
- Traitement des tableaux multidimensionnels : Lorsque des éléments sont ajoutés à un tableau multidimensionnel, array_push() peut ajouter des sous-tableaux comme éléments. Cela peut être utile dans les situations où vous travaillez avec des structures de données complexes et souhaitez y insérer de nouvelles collections de données.
- Considérations de performance : Bien que array_push() soit généralement rapide pour des tableaux de taille modérée, pour des tableaux très volumineux ou lorsqu'il est utilisé fréquemment dans des boucles, il peut avoir un impact sur les performances. Dans ce cas, d'autres structures de données comme les SplQueue ou SplStack peuvent être envisagées.
- Manipulation de tableaux à clefs numériques : array_push() ajoute les éléments à la fin du tableau avec des clefs numériques successives. Si vous avez déjà un tableau avec des clefs numériques non consécutives, les nouveaux éléments seront ajoutés avec les index appropriés (par exemple, si un tableau a les indices 0, 5 et 7, le prochain indice sera 8).
Exemple
Voici quelques exemples typiques de l'utilisation de cette fonction :
- <?php
- $Mois = array("Janvier","Février","Mars");
- array_push($Mois,"Avril");
- var_dump($Mois);
- ?>
on obtiendra le résultat suivant :
array(4) { [0]=> string(7) "Janvier" [1]=> string(7) "Février" [2]=> string(4) "Mars" [3]=> string(5) "Avril" }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