|table_valeur

O filtro |table_valeur{chave,valor padrão} devolve o valor associado a uma chave numa matriz.

  • Apparu en : SPIP 1.9

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.

Ver também

Autor Ricardo Porto Publié le : Mis à jour : 10/03/25

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