SPIP

[ar] [ast] [bg] [br] [ca] [co] [cpf] [cs] [da] [de] [en] [eo] [es] [eu] [fa] [fon] [fr] [gl] [id] [it] [ja] [lb] [nl] [oc] [pl] [pt] [ro] [ru] [sk] [sv] [tr] [vi] [zh] Espace de traduction

Télécharger

|push

Décembre 2009

Toutes les versions de cet article :

|push permet d’ajouter une valeur à la fin d’un tableau.


Le filtre |push (depuis SPIP 2.0) s’applique à une balise contenant un tableau PHP (voir #ARRAY) et y ajoute une nouvelle valeur.

La clé est incrémentée de 1 à chaque nouvelle valeur. Si aucune clé n’a été définie pour la première valeur, le tableau est indexé à partir de 0 (la première clé est 0).

[(#GET{un_tableau}|foreach)] affiche :

  • 5=> une_valeur
  • 6=> une_autre_valeur
  • 7=> une_troisieme_valeur

La première clé est 5 parce qu’elle a été précisée lors de la création du tableau (premier #SET).

Exemple courant d’usage de |push :

Si les articles sélectionnés par la BOUCLE portent les numéros 2, 5 et 10, [(#GET{mes_articles}|foreach)] retourne :

  • 0=>2
  • 1=>5
  • 2=>10

Ici, la première clé est zéro car aucune clé n’a été définie préalablement.

Contrairement à la [fonction PHP array_push<code>->http://fr.php.net/manual/fr/function.array-push.php], <code>|push ne produit pas de message d’erreur si la balise filtrée n’est pas un tableau.


Voir le squelette de cette page Site réalisé avec SPIP | Espace de traduction | Espace privé