AppleScript

ARRAY
La commande array permet la manipulation des variables de type tableau associatif.
Syntaxe array Sous-Commande Tableau?Arg Arg…?

Description
En fonction de la sous-commande utilisée, la commande array permet d’accomplir toutes sortes de tˆaches concernant les variables tableau. Dans tout ce qui suit l’argument Tableau designe une variable valide de ce type. Les sous-commandes reconnues sont les suivantes:
array anymore Tableau IdRecherche Renvoie 1 s’il reste des ´ el´ements ` a examiner dans une recherche au sein d’un tableau, 0 si tous les ´ el´ements ont ´ et´ e renvoy´es. L’argument IdRecherche est une valeur obtenue ant´erieurement grˆace ` a la commande array startsearch et indique quelle recherche effectuer dans le tableau. Cette option est utile lorsqu’un tableau poss`ede un el´ement avec un nom vide car la valeur obtenue par une instruction array nextelement n’indique pas si la recherche a abouti.

array donesearch Tableau IdRecherche Cette commande met fin ` a une recherche (c’est-`a-dire un parcours a travers tous les ´ el´ements du tableau) et d´etruit l’´etat associe ` a cette recherche; elle renvoie une chaˆıne vide. L’argument IdRecherche est une valeur obtenue anterieurement grˆace ` a la commande array startsearch et indique quelle recherche d´etruire dans le tableau.
array exists Tableau Renvoie 1 si Tableau est effectivement une variable de type tableau, 0 s’il n’y a pas de variable de ce nom ou bien s’il s’agit d’une variable de type scalaire.
array get Tableau?Motif? Renvoie une liste constitu´ ee de paires d’elements. Le premier element est le nom d’un ´ el´ement de Tableau et le second ´ el´ement est la valeur qui lui est associ2e. L’ordre des paires est ind´efini. Si l’argument Motif n’est pas sp´ecifi´ e, tous les elements du tableau figurent dans le resultat, sinon, seulement les ´ el´ementsdont le nom correspond au motif y sont inclus. Les regles concernant la syntaxe du motif sont les mˆemes qu’avec la commande string match (cf. p. 174). Si Tableau n’est pas le nom d’une variable de type tableau ou si celui-ci n’a aucun ´ el´ement alors une liste vide est renvoyee.

array names Tableau?Mode??Motif? Renvoie une liste constitu´ ee des noms de tous les elements du tableau qui correspondent au motif Motif. L’argument optionnel Mode a ´ et´ e introduit avec la version 8.4 de Tcl: il peut avoir l’une des valeurs -exact, -glob ou -regexp. Ce mode concerne le type de r`egle ` a appliquer pour chercher des correspondances entre les noms et le motif: avec les options -glob ou -regexp le motif peut contenir des m´etacaract` eres selon la syntaxe reconnue respectivement par les commandes string match (cf. p. 174) ou bien regexp (cf. p. 142). Avec l’option -exact, il doit y avoir correspondance litt´erale entre le nom et le motif. L’option par d´efaut est -glob. Si Tableau n’est pas le nom d’une variable de type tableau ou si aucun ´ el´ement ne correspond au motif alors une liste vide est renvoy´ee. array nextelement Tableau IdRecherche Renvoie le nom de l’´ el´ement suivant dans le tableau Tableau, ou une chaˆıne vide si tous les ´ elements du tableau ont d´ej` a ´ et´ e renvoy´ es par une recherche de ce type. L’argument IdRecherche est une valeur obtenue ant´erieurement grˆace ` a la commande array startsearch et identifie la recherche. Si des elements sont ajout´ es ou supprim´ es du tableau, toutes les recherches sont immediatement interrompues comme si une commande arraydonesearch avait ete executee; les operations array next elemen  echoueront alors sur ces recherches.