FIND_EQ_*** : premier élément d'un tableau égal à une valeur donnée
Traduction de la notice originale
Description de la fonction
La fonction FIND_EQ_*** recherche le premier élément d'un tableau égal à une valeur donnée.
NOTE : avant de lancer la recherche, le bloc écrit immédiatement ‑1 dans sa sortie OUT pour indiquer que la valeur associée à IN2 est introuvable. Il lance ensuite la recherche et met à jour la sortie OUT avec la valeur de rang du premier élément remplissant les critères de recherche.
Les paramètres supplémentaires EN et ENO peuvent être configurés.
Fonctions disponibles
Les fonctions disponibles sont les suivantes :
Représentation en FBD
Représentation appliquée à un tableau d'entiers :
Représentation en LD
Représentation appliquée à un tableau d'entiers :
Représentation en IL
Représentation appliquée à un tableau d'entiers :
LD Array1
FIND_EQ_ARINT Value1
ST Row_Value1
Représentation en ST
Représentation appliquée à un tableau d'entiers :
Row_Value1:= FIND_EQ_ARINT(Array1, Value1);
Description des paramètres
Le tableau suivant décrit les paramètres d’entrée :
Paramètre
Type
Commentaire
Array1
ARRAY [n..m] OF INT
ARRAY [n..m] OF DINT
ARRAY [n..m] OF WORD
ARRAY [n..m] OF DWORD
ARRAY [n..m] OF REAL
n et m sont des entiers positifs, négatifs ou nuls.
Value1
Valeur dont le rang est recherché dans Array1.
Du même type que les éléments du tableau Array 1.
Le tableau suivant décrit le paramètre de sortie :
Paramètre
Type
Commentaire
Row_Value1
Rang du premier élément de Array1 égal à Value1. Si aucun des éléments du tableau n'est égal à Value1, Row_Value1 = ‑1
Erreurs d’exécution
Lorsque le tableau contient une valeur incorrecte ou lorsque Value1 est une valeur incorrecte, le résultat de la fonction contient ‑2 et le bit %S18 est égal à 1.