Utilização
|table_valeur{chave,valor padrão}
O filtro |table_valeur
aplica-se a uma tag contendo uma matriz, toma uma chave da matriz como parâmetro e devolve o valor associado a essa chave.
Ver a tag #ARRAY para uma explicação mais geral sobre matrizes.
Exemplo:
#SET{uma_matriz,#ARRAY{0,vermelho,1,azul,2,verde}}
[(#GET{uma_matriz}|table_valeur{2})]
…devolve verde.
O parâmetro opcional valor padrão permite especificar um valor a devolver se o valor não for encontrado (a chave não existe ou a tag filtrada não é uma matriz).
[(#GET{uma_matriz}|table_valeur{3,preto})]
devolve preto porque não existe a chave 3.
Com matrizes "linearizadas"
|table_valeur
também funciona com as matrizes "linearizadas", por exemplo, as matrizes devolvidas pelas tags #ENV
e #CONFIG
(mas estas tags dispõem da sua própria sintaxe para aceder aos valores da matriz).
A tabela linearizada acima produz isto:
a:3:{i:0;s:5:"vermelho";i:1;s:4:"azul";i:2;s:4:"verde";}
[(#GET{uma_matriz}|table_valeur{2})]
devolve sempre verde.