FIND_EQP_*** : premier élément d'un tableau égal à une valeur, en commençant à un rang donné
Traduction de la notice originale
Description de la fonction
La fonction FIND_EQP_*** recherche le premier élément d'un tableau égal à une valeur donnée, en commençant à un rang précis.
NOTE : Avant de lancer la recherche, le bloc écrit immédiatement -1 dans sa sortie OUT pour indiquer que la valeur associée à IN 2 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_EQP_ARINT Value1, Begin1
ST Row_Value1
Représentation en ST
Représentation appliquée à un tableau d'entiers :
Row_Value1:= FIND_EQP_ARINT(Array1, Value1, Begin1);
Description des paramètres
Le tableau suivant décrit les paramètres d’entrée :
Paramètre
Type
Commentaire
Array1
ARRAY [n…m] OF WORD
ARRAY [n…m] OF DWORD
ARRAY [n..m] OF INT
ARRAY [n…m] OF DINT
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 Array1.
Begin1
Rang à partir duquel commence la recherche.
Le tableau suivant décrit les paramètres 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.
Remarque : Row_Value1 indique le rang par rapport au début du tableau.
Erreurs d'exécution
Lorsque le tableau contient une valeur non valide ou lorsque Value1 est une valeur non valide, le résultat de la fonction contient -2 et le bit %S18 est sur 1.