Retour au sommaire des PlugITs Misc
"List" PlugIT
Une liste dynamique de variables
Paramètres |
|
1 |
Type de variable. Les type disponibles sont Int (nombre entier), Float (nombre décimal), Hexa (nombre hexadécimal) et String (texte). |
2 |
Éléments par défaut de la liste. |
3 |
Permet de changer les éléments par défaut de la liste. Saisir la valeur dans le champ texte et cliquer sur le bouton "+" permet d'ajouter une valeur à la liste. Cliquer sur le bouton "-" supprime l'élément sélectionné dans la liste. |
A propos des index
Pour récupérer ou modifier un élément particulier de la liste à l'aide d'actions, vous devrez désigner l'élément avec lequel vous souhaitez interagir à l'aide d'un index. Les index sont compris entre 0 et n-1, n étant le nombre d'élément dans la liste.
Ainsi, le premier élément de la liste est à l'index 0, et le dernier élément d'une liste de longueur n aura pour index n-1.
Exemple : le 3ème élément de la liste sera à l'index 2.
Il faut également noter que pour l'utilisation des actions "Next element", "Get current element" et "Previous element", le plugIT dispose d'un index interne initialisé à -1 et automatiquement mis à jour. La valeur -1 équivaut au début du parcours et permet de parcourir la liste depuis le premier élément ou depuis le dernier élément.
Actions |
|
Reset |
Vide la liste et réinitialise l'index interne à -1 (début du parcours). |
Concat |
Modifie l'élément dont l'index est en paramètre de lien. |
Decrement |
Modifie l'élément dont l'index est en paramètre de lien. |
Increment |
Modifie l'élément dont l'index est en paramètre de lien. |
Previous element |
Décrémente l'index interne et renvoie l'élément correspondant. Permet de parcourir la liste du dernier élément au premier. Si le début de la liste a été atteint, envoie l'événement "Start of list". |
Next element |
Incrémente l'index interne et renvoie l'élément correspondant. Permet de parcourir la liste du premier élément au dernier. Si la fin de la liste a été atteint, envoie l'événement "End of list". |
Get current element |
Permet de récupérer l'élément désigné par l'index interne. |
Set index |
Change l'index interne avec celui fourni en paramètre de lien. En absence de paramètre de lien, l'index est changé à -1 (début du parcours). |
Remove element |
Supprime l'élément dont l'index est en paramètre de lien. En absence de paramètre de lien, supprime le premier élément de la liste. |
Add element |
Ajoute la valeur en paramètre de lien à la fin de la liste. |
Get element |
Permet de récupérer l'élément dont l'index est en paramètre de lien. |
Set element |
Change la valeur de l'élément par la valeur donnée en paramètre de lien après l'index de l'élément à modifier (Exemple : pour mettre "Bonjour" dans le 3ème élément de la liste, le paramètre de lien sera : 2 Bonjour). |
Get all values |
Permet de récupérer tous les éléments de la liste. Les éléments sont envoyés les uns après les autres dans des événements "Value". |
Get list |
Permet de récupérer l'intégalité des éléments de la liste au format CSV (elem1;elem2;elem3;...elemn;). |
Set list |
Change l'intégralité des valeurs de la liste par les valeurs en paramètre de lien, au format CSV. |
Évènements |
|
Start of list |
Déclenché quand l'événement "Previous element" est appelé alors que le début de la liste a déjà été atteint. |
End of list |
Déclenché quand l'événement "Next element" est appelé alors que la fin de la liste a déjà été atteinte. |
Modified |
Déclenché quand un élément de la liste est modifié. Contient l'index et la nouvelle valeur de l'élément dans le paramètre de lien. |
Element |
Renvoie la valeur d'un élément de la liste. Déclenché par l'action "Get element" ou "Get current element". |
Value |
Renvoie tous les éléments de la liste, un par un. Chaque événement ne contient la valeur que d'un seul élément de la liste en paramètre de lien. Déclenché par l'action "Get all values". |
List |
Renvoie l'intégalité des valeurs de la liste au format CSV. Déclenché par l'action "Get list". |