|table_valeur

Le filtre |table_valeur{clé,valeur par défaut} retourne la valeur associée à une clé dans un tableau.

  • Apparu en : SPIP 1.9

Utilisation

|table_valeur{clé,valeur par défaut}

Le filtre |table_valeur s’applique à une balise contenant un tableau, prend une clé du tableau comme paramètre et retourne la valeur associée à cette clé.

Voir la balise #ARRAY pour une explication plus générale sur les tableaux.

Exemple

#SET{un_tableau,#ARRAY{0,rouge,1,bleu,2,vert}}
[(#GET{un_tableau}|table_valeur{2})]

…retourne vert.

Le paramètre optionnel valeur par défaut permet de préciser une valeur à retourner si la valeur n’est pas trouvée (la clé n’existe pas ou la balise filtrée n’est pas un tableau).

[(#GET{un_tableau}|table_valeur{3,noir})] retourne noir parce qu’il n’y a pas de clé 3.

Avec des tableaux "linéarisés"

|table_valeur fonctionne aussi avec des tableaux "linéarisés", par exemple, les tableaux retournés par les balises #ENV et #CONFIG (mais ces balises disposent de leur propre syntaxe pour accéder aux valeurs du tableau).

Le tableau ci-dessus linéarisé donne ceci :

a:3:{i:0;s:5:"rouge";i:1;s:4:"bleu";i:2;s:4:"vert";}

[(#GET{un_tableau}|table_valeur{2})] retourne toujours vert.

Voir aussi

Auteur Aurélie Publié le : Mis à jour : 17/07/23

Traductions : català, English, Español, français, Nederlands