Note :

Il offre les fonctions suivantes:

• array_list : traitement des éléments d'un tableaux
• array_fld : renvoie une propriété d'un élement d'un tableau traité par la fonction array_list
• ksort : renvoie un tableau trié par clef
• arraysplit : affecte les éléments d'un tableau à des variables

Voir aussi

• Dans le module core, la fonction ~array() permet la création de tableaux de données

array_list

La fonction array_list() permet d'effectuer des opérations sur un tableau. La fonction reprend le fonctionnement de ~list().

Avec les séquences LF, LM, LR, LL, etc, on peut effectuer un traitement (le plus souvent un affichage) différent selon qu'on affiche le premier élément du tableau, les suivants ou le dernier.

La fonction array_list() prend comme arguments le tableau, l'indice à partir duquel on effectue le traitement, le nombre de lignes du tableau à utiliser (si l'argument est absent le restant du tableau est utilisé) puis un nombre d'arguments couplés par deux dont le premier argument du couple peut être soit: LM, LR, LN, LD, LF, LL ou LE.

Appelons A le premier argument du couple, B le deuxième argument du couple.

• Si A est égal à LF, B est évalué lors du premier traitement.
• Si A est égal à LM, B est évalué pour chaque traitement, y compris le premier mais il sera alors évalué après celui de LF, et avant celui de LL.
• Si A est égal à LR, B est évalué lors du premier traitement, comme LF, mais LM n'est pas évalué pour ce même traitement, et on passe directement au suivant.
• Si A est égal à LL, B est évalué pour le dernier traitement, après celui de LM.
• Si A est égal à LN, B est évalué pour le dernier traitement, comme LL, mais LM n'est pas évalué pour ce même traitement, et ensuite on s'arrête.
• Si A est égal à LD, B est évalué en cas de non traitement d'informations.
• Si A est égal à LE, B est évalué en cas d'erreur.

LE est évalué si le premier argument de la fonction n'est pas un tableau. LD est évalué si ce tableau est vide.

array_fld

La fonction array_fld() prend un seul argument, celui ci pouvant être :

• 'current' : renvoie l'élément courant du tableau.
• 'count' : renvoie le numéro de l'élément courant.
• 'key' : renvoie la clé associée à l'élément courant.

Exemple

~set('tab[un]','premier')
~set('tab[deux]','deuxième')
~set('tab[trois]','troisième')
~array_list(~get('tab'),0,,'LM','le chiffre ~array_fld('key') est ~array_fld('current')<br />')

=>
le chiffre un est premier
le chiffre deux est deuxième
le chiffre trois est troisième

ksort

La fonction ksort() permet de trier un tableau par ordre de clef
La tableau à trier est passé en argument.

Exemple

~set('tableau[3]','pomme')
~set('tableau[1]','poire')
~set('tableau[2]','banane')
~print_r(~ksort(~get('tableau')))

=>
Array
(
    [1] => poire
    [2] => banane
    [3] => pomme
)

arraysplit

La fonction arraysplit() permet de affecter les valeurs d'un tableau à des variables
Le premier argument est le tableau dont il faut affecter les valeur
Ensuite suivent le nom de variables à affecter.

Exemple

~set('tab',~array("a","b","c"))
~arraysplit(~get('tab'),'x','y','z')

x:~get('x')
y:~get('y')
z:~get('z')

=>

x:a
y:b
z:c