SearchValue (FPScript)

21.09.2021

Sucht nach einem oder mehreren Werten in einem Datensatz.

Syntax

SearchValue(DataSet, Value)

 

Die Syntax der SearchValue-Funktion besteht aus folgenden Teilen:

Teil

Beschreibung

DataSet

Eine Datenreihe oder ein Signal in dem nach Werten gesucht werden soll. Wenn Sie ein Signal angeben, wird nur die Y-Komponente durchsucht.

Es sind alle Datenstrukturen erlaubt außer Einzelwert und Liste. Es sind alle numerischen Datentypen erlaubt.

Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste.

Value

Ein Einzelwert oder eine Datenreihe mit den Werten, nach denen gesucht werden soll. Wenn als Wert Empty übergeben wird, liefert die Funktion als Ergebnis ebenfalls Empty.

Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle numerischen Datentypen erlaubt. Die Einheit muss mit der von Parameter DataSet kompatibel sein.

Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

Anmerkungen

Es sind alle numerischen Datentypen erlaubt. Ist DataSet eindimensional, dann ist das Ergebnis ein Einzelwert bzw. eine Datenreihe mit den Positionen der gefundenen Werte. Ansonsten ist es eine Datenmatrix mit den 2D-Indizes der gefundenen Werte.. Der zu suchende Wert muss nicht exakt im Datensatz vorliegen. Es wird dann die Position des Wertes im Datensatz übergeben, der dem Suchwert am nächsten kommt. Wenn dies für mehrere identische Werte im Datensatz gilt, dann wird die Position des ersten dieser Werte übergeben. Das Argument Value darf keine ungültigen Fließkommawerte enthalten.

Bei komplexen Datentypen erfolgt eine Betragsbildung.

Verfügbarkeit

FlexPro Basic, Professional, Developer Suite

Beispiele

SearchValue({1,2,3,2,1}, 2)

Ergibt 1L. Dies entspricht der Position der ersten "2" im Datensatz.

Signal.y[SearchValue(Signal.X, 1.5)]

Entspricht Signal[[1.5]].

SearchValue({1,2,3,2,1}, {2.1, 2.9})

Ergibt {1L, 2L}.

Siehe auch

SearchVoidValues-Funktion

Indexoperator

Artikel teilen oder als Email versenden:

Diese Beiträge könnten Sie ebenfalls interessieren