Les tableaux

Les tableaux sont disponibles à partir de la version 4.0a3.

Leur mise en œuvre passe par l'utilisation de la balise <array...>
D'autres balises ont été modifiées pour les exploiter :

<while array="...">

<array name="..." value="..." [header="..."] [delimiter="..."]>

Header permet de définir les noms des colonnes

Delimiter permet d'indiquer le caractère qui sépare les valeurs (par défaut, ce caractère est |)

<array name="adresses" header="id, raisonSociale, adresse,  codePostal, ville, pays"
       value="[ { 1,|Infocosme |, | 51 rue Bellecombe|, 69006, Lyon, France },
                { 2,|Le Béranger|, |1, rue Béranger|, 69006, Lyon, France } ]">

Dimensions et noms de colonnes

Deux variables sont créées pour les dimensions du tableau :

$xxx.rowcount$ : nombre de lignes
$xxx.colcount$ : nombre de colonnes

$#xxx$ donne la liste des nom des colonnes, séparés par des virgules.

$#xxx.[col]$ : donne le nom de la colonne N° col

<set name="nbLignes" value="$adresses.rowcount$">
<set name="i" value="1">
<while expr="$i$<=$adresses.colcount$">
	 $i$:$#adresses.[i]$
	<set name="i" expr="$i$+1">
</while>

Cellules

Les cellules du tableau s'adressent par la notation $nomtableau:lig.col$

où col est le N° de colonne et lig le N° de ligne

<set name="rs1" value="$adresses:1.raisonSociale$">

<set name="adr" value="$adresses:1.3$">

Colonne

<set name="adr1" value="$adresses:1.adresse$">

<set name="CP2" value="$adresses:2.4$">

Ligne

<set name="lig1" value="$adresses:1$">

L'affectation d'un tableau à une variable provoque par défaut sa "stringification", on obtient une chaîne de caractères (et on perd l'éventuel header).

<set name="toto" value="$adresses$">
=> toto vaut alors "{1,|Infocosme |,| 51, rue Bellecombe|,,69006,Lyon,France},{2,Le Béranger,|1, rue Béranger|,| |,69006,Lyon,France}">

Le délimiteur | peut être remplacé en définissant la variable phcarraydelimiter.

Pour conserver la notion de tableau, il faut utiliser une * devant value et ne pas mettre les $...$ (le tableau est alors copié) :

<set name="tutu" *value="adresses">

<function exec="maFunc" *tab="adresses">

<array name="..." option="" [row="..."] [col="..."] value="...">

Les options permettent d'indiquer le mode d'affectation :

option="set" : affectation d'une valeur à une cellule particulière
option="replace" : replacement de ligne(s)+colonne(s)
option="colshift" : insertion de colonne(s)
option="rowshift" : insertion de lignes
option="shift" : insertion de lignes+colonne(s)
option="colpush" : insertion de colonne(s) à la fin (pas d'attribut col)
option="rowpush" : insertion de ligne(s) à la fin (pas d'attribut row)

<array name="adresses" option="rowpush" value="[{5,|Pizza Paolino|,|250 cours Lafayette|,69003,|Lyon|,|France|">

Les tableaux

Introduction

Initialisation

<array name="..." value="..." [header="..."] [delimiter="..."]>

Utilisation

Dimensions et noms de colonnes

Cellules

Colonne

Ligne

Affectation

Affectation avec attribut option

<array name="..." option="" [row="..."] [col="..."] value="...">

Télécharger

FAQ

Don