Indexer un tableau
- Mise à jour2023-02-17
- Temps de lecture : 3 minute(s)
Indexer un tableau
Renvoie la valeur stockée dans un tableau à un indice spécifié.
Entrées/Sorties
tableau
Un tableau à n dimensions de n'importe quel type.
Si tableau est un tableau vide, élément renvoie la valeur par défaut du type de données défini pour le tableau.
indice
Un nombre qui fait référence à un emplacement dans le tableau en entrée.
Ce nœud fournit automatiquement une entrée indice pour chaque dimension du tableau.
Default value: 0
Comportement en cas de valeurs hors gamme
Si l'indice d'une dimension est inférieur à zéro ou supérieur à la longueur du tableau dans cette dimension, ce nœud renvoie la valeur par défaut du type de données défini pour le tableau.
Relation entre les entrées indice et les dimensions de tableau
Pour les tableaux multidimensionnels, les entrées indice correspondent à l'ordre row-major. Autrement dit, le premier indice correspond à la dernière dimension de l'entrée tableau, et le dernier indice correspond à la première dimension de l'entrée tableau. Le tableau suivant montre la relation entre quatre entrées indice et les dimensions d'une entrée tableau 4D.
| Ordre de l'indice | Dimension correspondante dans l'entrée tableau | Nom de l'indice |
|---|---|---|
| 1 | 4e | indice de volume |
| 2 | 3e | indice de page |
| 3 | 2e | indice de ligne |
| 4 | 1er | indice de colonne |
Entrées indice non câblées
Les entrées indice non câblées vous permettent d'obtenir un sous-tableau du tableau plutôt qu'un seul élément. Par exemple, pour obtenir la colonne 1 d'un tableau 2D, spécifiez 1 comme indice de colonne et laissez l'indice de ligne non câblé.
Quand aucune des entrées indice n'est câblée, le sous-tableau extrait contient une dimension de moins que tableau.
Relation entre indice et plusieurs sorties élément ou sous-tableau
Si vous développez le nœud pour afficher plusieurs sorties élément ou sous-tableau, le nœud fournit un ensemble d'entrées indice pour chaque sortie. Les valeurs que vous câblez à un ensemble d'entrées indice déterminent la valeur de la sortie correspondante. Cependant, si vous ne câblez pas de valeurs à un ensemble d'entrées indice, la sortie élément ou sous-tableau correspondante renvoie l'élément ou sous-tableau qui suit la sortie élément ou sous-tableau précédente dans le tableau d'origine. Reportez-vous à l'onglet Exemples pour voir une illustration de cette relation.
élément
Élément ou sous-tableau scalaire stocké dans tableau à l'indice spécifié.
Comportement de redimensionnement
Lorsque vous câblez un tableau à ce nœud, le nœud se redimensionne automatiquement pour afficher des entrées indice pour chaque dimension du tableau que vous avez câblé à tableau. Vous pouvez aussi ajouter des sorties élément ou sous-tableau supplémentaires en redimensionnant le nœud. Le nœud fournit des entrées indice pour chaque sortie.
Accéder à un sous-tableau en désactivant l'indexation dans une dimension
Vous pouvez désactiver l'indexation sur une dimension en ne câblant pas l'entrée indice correspondante. Par défaut, l'indexation est activée dans la première dimension, alors qu'elle ne l'est pas dans les autres. Vous pouvez câbler une constante ou une commande aux entrées indice que vous voulez activer.
Par exemple, si vous voulez indexer une ligne dans un tableau 2D, la première entrée indice est activée et la seconde entrée indice est désactivée. Si vous voulez aussi indexer ce même tableau 2D par colonnes, vous pouvez redimensionner le nœud afin d'afficher un autre ensemble de terminaux d'entrée. Cet ensemble d'entrées possède sa propre sortie élément correspondante. Par défaut, si vous ne câblez aucun terminal d'entrée indice, le premier élément indexe la ligne 0, le deuxième élément indexe la ligne 1, et ainsi de suite.