43 lines
5.9 KiB
HTML
43 lines
5.9 KiB
HTML
|
<HTML><HEAD>
|
|||
|
|
<BASEFONT FACE="Times New Roman" SIZE="2" COLOR="#000000">
|
|||
|
|
</HEAD>
|
|||
|
|
<BODY>
|
|||
|
|
<div><H3><b>array Commandes Internes Tcl</b></H3></div>
|
|||
|
|
<HR ALIGN="center">
|
|||
|
|
<div><b>NOM</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;">array - Manipule les variables tableau
|
|||
|
|
</div> <br>
|
|||
|
|
<div><b>SYNTAXE</b></div> <br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;"><b>array </b><i>option arrayName</i> ?<i>arg arg ...</i>?
|
|||
|
|
</div><br>
|
|||
|
|
<div><b>DESCRIPTION</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;">Cette commande effectue une des op<6F>rations sur la variable donn<6E>e par <i>arrayName</i>. Sauf sp<73>cification contraire pour certaines commandes individuelles ci-dessous, <i>arrayName</i> doit <20>tre le nom d'une variable tableau existante. L'argument <i>option</i> d<>termine l'action effectu<74>e par la commande. Les <i>options</i> l<>gales (qui peuvent <20>tre abr<62>g<EFBFBD>es) sont:
|
|||
|
|
<DL>
|
|||
|
|
<DT><b>array anymore </b><i>arrayName searchId</i><br></DT><DD>Renvoie 1 s'il reste au moins un <20>l<EFBFBD>ment <20> traiter pour une recherche dans le tableau, 0 si tous les <20>l<EFBFBD>ments ont d<>j<EFBFBD> <20>t<EFBFBD> renvoy<6F>s. <i>SearchId</i> indique la recherche <20> v<>rifier dans <i>arrayName</i>, et doit avoir <20>t<EFBFBD> la valeur de retour d'un pr<70>c<EFBFBD>dent appel de <b>array startsearch</b>. Cette option est particuli<6C>rement utile si un tableau contient un <20>l<EFBFBD>ment avec un nom vide, parce que la valeur de retour de <b>array nextelement</b> n'indiquera pas si la recherche est termin<69>e.
|
|||
|
|
<br></DD>
|
|||
|
|
<DT><br><b>array donesearch </b><i>arrayName searchId</i></DT><DD>Cette commande termine une recherche dans un tableau et d<>truit l'<27>tat associ<63> <20> cette recherche. <i>SearchId</i> indique quelle recherche d<>truire dans <i>arrayName</i>; et doit avoir <20>t<EFBFBD> la valeur de retour d'un pr<70>c<EFBFBD>dent appel de <b>array startsearch</b>. Renvoie une cha<68>ne vide.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>array exists </b><i>arrayName</i>
|
|||
|
|
</DT><DD>Renvoie 1 si <i>arrayName</i> est une variable tableau, 0 s'il n'y a pas de variable de ce nom ou si c'est une variable scalaire. </DD>
|
|||
|
|
<DT><br><b>array get </b><i>arrayName</i> ?<i>pattern</i>? </DT><DD>
|
|||
|
|
Renvoie une liste contenant des paires d'<27>l<EFBFBD>ments. Le premier <20>l<EFBFBD>ment de chaque paire est le nom d'un <20>l<EFBFBD>ment de <i>arrayName</i> et le second <20>l<EFBFBD>ment de chaque paire est la valeur de l'<27>l<EFBFBD>ment de tableau. L'ordre des paires est ind<6E>fini. Si <i>pattern</i> n'est pas sp<73>cifi<66>, alors tous les <20>l<EFBFBD>ments du tableau sont inclus dans le r<>sultat. Si <i>pattern</i> est sp<73>cifi<66>, alors seuls les <20>l<EFBFBD>ments dont les noms correspondent <20> <i>pattern</i> (en utilisant les r<>gles de correspondances de <b>string match</b>) sont inclus. Si <i>arrayName</i> n'est pas le nom d'une variable tableau, ou si le tableau ne contient pas d'<27>l<EFBFBD>ments, alors une liste vide est renvoy<6F>e.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>array names </b><i>arrayName</i> ?<i>pattern</i>?<br></DT><DD>Renvoie une liste contenant le noms de tous les <20>l<EFBFBD>ments dans le tableau qui correspondent <20> <i>pattern</i> (en utilisant les r<>gles de correspondance de <b>string match</b>). Si <i>pattern</i> est omis alors la commande renvoie tous les noms des <20>l<EFBFBD>ments dans le tableau. S'il n'y a pas d '<27>l<EFBFBD>ments (correspondants) dans le tableau, ou si <i>arrayName</i> n'est pas le nom d'une variable tableau, alors une cha<68>ne vide est renvoy<6F>e.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>array nextelement </b><i>arrayName searchId</i><br></DT><DD>Renvoie le nom de l'<27>l<EFBFBD>ment suivant dans <i>arrayName</i>, ou une cha<68>ne vide si tous les <20>l<EFBFBD>ments de <i>arrayName</i> ont d<>j<EFBFBD> <20>t<EFBFBD>s renvoy<6F> dans cette recherche. L'argument <i>searchId</i> identifie la recherche, et doit avoir <20>t<EFBFBD> la valeur de retour d'une commande<b> array startsearch</b>. Attention: si des <20>l<EFBFBD>ments sont ajout<75>s <20> ou effac<61>s de ce tableau, alors toutes les recherches sont automatiquement termin<69>es exactement comme si <b>array donesearch</b> avait <20>t<EFBFBD> appel<65>e; ceci causerait l'echec des op<6F>rations <b>array </b><b>nextelement</b> pour ces recherches.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>array set </b><i>arrayName list</i><br></DT><DD>Fixe les valeurs d'un ou plusieurs <20>l<EFBFBD>ments de <i>arrayName</i>. <i>list</i> doit avoir une forme identique <20> celle renvoy<6F>e par <b>array get</b>, consistant d'un m<>me nombre d'<27>l<EFBFBD>ments. Chaque <20>l<EFBFBD>ment impair dans <i>list</i> est trait<69> comme un nom d'<27>l<EFBFBD>ment dans <i>arrayName</i>, et les <20>l<EFBFBD>ments suivants de <i>list</i> sont utilis<69>s comme une nouvelle valeur pour cet <20>l<EFBFBD>ment de tableau. Si la variable <i>arrayName</i> n'existe pas d<>j<EFBFBD> et que <i>list</i> est vide, <i>arrayName</i> est cr<63><72>e avec une valeur tableau vide.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>array size </b><i>arrayName</i><br></DT><DD>Renvoie une cha<68>ne d<>cimale donnant le nombre d'<27>l<EFBFBD>ments dans le tableau. Si <i>arrayName</i> n'est pas le nom d'un tableau alors 0 est renvoy<6F>.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>array startsearch </b><i>arrayName</i><br></DT><DD>Cette commande initialise une recherche <20>l<EFBFBD>ment-par-<2D>l<EFBFBD>ment dans le tableau d<>sign<67> par <i>arrayName</i>, dont les appels de la commande <b>array </b><b>nextelement</b> renverront les noms des <20>l<EFBFBD>ments individuels dans le tableau. Quand la recherche est termin<69>e, la commande tableau<b> donesearch</b> sera appel<65>e. La valeur de retour est un identificateur de recherche qui doit <20>tre utilis<69> dans les commandes<b> array nextelement</b> et <b>array </b><b>donesearch</b>; il permet <20> de multiples recherches d'<27>tre men<65>es simultan<61>ment sur le m<>me tableau.
|
|||
|
|
</DD>
|
|||
|
|
<DT><br><b>array unset </b><i>arrayName</i> ?<i>pattern</i>?
|
|||
|
|
</DT><DD>Efface tous les <20>l<EFBFBD>ments du tableau qui correspondent <20> <i>pattern</i> (en utilisant les r<>gles correspondantes de <b>string match</b>). Si <i>arrayName</i> n'est pas le nom d'une variable tableau ou qu'il n'y a pas d'<27>l<EFBFBD>ments correspondant dans le tableau, alors une cha<68>ne vide est renvoy<6F>e. Si <i>pattern</i> est omis et que c'est une variable tableau, alors la commande efface le tableau entier.</DD>
|
|||
|
|
</DL></div><br>
|
|||
|
|
<div>Derni<EFBFBD>re r<>vision: 8.3</div>
|
|||
|
|
<br>
|
|||
|
|
<br><div ALIGN="CENTER"><A HREF="index.htm"><b>Index</b></A> <A HREF="88.htm"><b>Pr<EFBFBD>c<EFBFBD>dent</b></A> <A HREF="90.htm"><b>Suivant</b></A>
|
|||
|
|
</div>
|
|||
|
|
</BODY></HTML>
|