SearchValue (FPScript)
Recherche d'une ou plusieurs valeurs dans un ensemble de données.
Syntaxe
SearchValue(DataSet, Value)
La syntaxe de la fonction SearchValue se compose des éléments suivants :
Section |
Description |
|---|---|
DataSet |
Une série de données ou un signal à rechercher des valeurs. Si vous spécifiez un signal, seule la composante Y est recherchée. Toutes les structures de données sont autorisées, sauf Scalaire et Liste. Tous les types de données numériques sont autorisés. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
Value |
Une valeur scalaire ou une série de données avec les valeurs à trouver. Si la valeur Empty est passée, la fonction renvoie également le résultat Empty. Les structures de données autorisées sont Scalaire et Séries de données. Tous les types de données numériques sont autorisés. L'unité doit être compatible avec celle du paramètre DataSet . Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Remarques
Tous les types de données numériques sont autorisés. Si DataSet est unidimensionnel, le résultat est une valeur scalaire ou une série de données avec les positions des valeurs trouvées. Sinon, c'est une matrice de données avec les indices 2D des valeurs trouvées. La valeur à trouver ne doit pas nécessairement être présente exactement dans l'ensemble de données. La position de la valeur dans l'ensemble de données qui se rapproche le plus de la valeur recherchée est alors passée. Si cela s'applique à plusieurs valeurs identiques dans l'ensemble de données, la position de la première de ces valeurs est alors passée. L'argument Value ne peut pas contenir de valeurs à virgule flottante invalides.
Pour les types de données complexes, un nombre est formé.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
SearchValue({1,2,3,2,1}, 2) |
Renvoie 1L. Cela correspond à la position du premier "2" dans l'ensemble de données. |
Signal.y[SearchValue(Signal.X, 1.5)] |
Correspond à Signal [[1.5]]. |
SearchValue({1,2,3,2,1}, {2.1, 2.9}) |
Renvoie {1L, 2L}. |