Spécifier la valeur d'un élément dans un champ indexé

Ensembles de données et paramètres › Paramètres de processus › Paramètres calculés › Accéder aux champs d'ensemble de données dans les expressions › Spécifier la valeur d'un élément dans un champ indexé

Spécifier la valeur d'un élément dans un champ indexé

La syntaxe suivante vous permet d'accéder à une valeur dans un champ indexé (tableau) :

référence_ensemble_de_données.nom_champ_indexé[index]

Le paramètre nom_champ_indexé spécifie le nom de champ dans l'ensemble de données. L'index est un nombre entier qui résout un élément indexé dans le tableau.

Utilisez la syntaxe suivante pour spécifier la chaîne nom_champ_indexé avec la notation par crochets. Dans l'exemple, expression_nom_champ_indexé est une expression CA Process Automation qui renvoie la chaîne nom_champ_indexé.

référence_ensemble_de_données[expression_nom_champ_indexé][index]

Comme les tableaux JavaScript, les champs indexés CA Process Automation sont des tableaux de tableaux plutôt que de vrais tableaux. Pour accéder à un élément dans un tableau de tableaux, il vous suffit d'utiliser l'opérateur [ ] deux fois. Par exemple, pour le champ de nombre entier indexé bidimensionnel appelé Nombres entiers, tous les éléments de liste Nombres entiers[x] représentent une liste indexée de nombres entiers. Pour accéder à un nombre entier spécifique dans le champ indexé, écrivez l'expression Nombres entiers[x][y]. En règle générale, vous utilisez la syntaxe suivante pour accéder à un élément de données pour un champ indexé de n-dimensions :

référence_ensemble_de_données.nom_champ_indexé[index1][index2] ... [indexn]

Le paramètre index est un nombre entier ou une expression qui renvoie un nombre entier. Le paramètre a une valeur qui comprise entre 0 (pour la première valeur de la liste indexée) et le nombre correspondant à la longueur de la liste moins 1. L'évaluation de l'index est circulaire. C'est pourquoi, lorsque la valeur d'index dépasse la longueur d'une liste indexée, la formule suivante permet de déterminer sa valeur :

Index_réel = index % longueur_liste ;

En d'autres termes, pour n éléments dans un champ indexé, vous obtenez les résultats suivants :

Un index de n renvoie l'élément 0.
Un index de n+1 renvoie l'élément 1.
Un index de n-1 renvoie le dernier élément.

Le tableau suivant illustre les résultats d'accès aux éléments d'un champ indexé dans un ensemble de données de processus :

Expression	Description
valeur = Process.X[2]	Se rapporte au troisième élément d'un champ indexé X de l'ensemble de données de processus.
valeur = Process.X[18]	Pour un champ indexé X avec une taille de 19, cette expression se rapporte à l'élément 19 de X, le même que Process.X[18].
valeur = Process.X[Process.Y + 2]	Une expression calcule l'index.
valeur = Process.A[5][2]	Renvoie la valeur dans un tableau bidimensionnel. Le troisième élément de la sixième liste indexée que le tableau définit, permettant de résoudre le tableau.