position()

Zusammenfassung

Gibt die Position des ersten Elements, die genau auf Ihre Suchkriterien aus einer list . In seiner einfachsten Form wird die Position des ersten Elements aus der list inList für Element. Sinnvoller ist es, zusätzlich einen Schlüssel anzugeben. Dabei handelt es sich um den Namen einer Funktion, der auf jeden Eintrag der Liste inList angewendet wird. Wenn kein Eintrag die Kriterien erfüllt, wird NoValue angezeigt.

Syntax

position ( item as Any, _
           inList As List, _
           Optional key As Any = :Identity ) As Any 

Argument	Typ	Beschreibung
item	any	Der gesuchte Wert
inList	list	List des Kandidaten. Nur das erste übereinstimmende Element wird zurückgegeben.
key	Any	Optional. kann entweder der Name einer Funktion oder einen integer ; Standard ist :Identity. Bei Verwendung eines Funktionsnamens wird die Funktion für jedes Element in der list . Die Funktion muss einen Wert zurückgeben, der mit item verglichen werden kann. Wenn Sie ein integer Wert, jedes Element in der list muss sich eine list . Der Wert steht für die Position in jeder Unterliste, die den Wert enthält, der mit item verglichen wird.

Beispiel 1

Eine Übereinstimmung

Intent >position(13, {11, 12, 13}) 
--> 3 

Hier integer Wert 13 Anpassung an Position 3.

Beispiel 2

Keine Übereinstimmung gefunden

Intent >position(7, {4, 8, 2}) 
--> NoValue 

Hier integer Wert 7 wurde nicht durch die Liste Elemente, sodass NoValue zurückgegeben wird.

Beispiel 3

Mithilfe einer key-Funktion

Intent >position(9, {{3, 6, 9}, {9, 5, 6}, {9, 1, 2}}, key := :first) 
--> 2 

In diesem Beispiel wird item verglichen, um nur die erste Profilelement der einzelnen lists in inList. Beachten Sie, dass nur die Position der ersten Übereinstimmung zurückgegeben wurde.

Beispiel 4

Verwenden eines Ganzzahlschlüssels

Intent >position(42, { {"abc", 10}, {"def", 42}, {"ghi", 18} }, key := 2) 
--> 2 

Hier, das zweite Element jeder Unterliste ist mit item verglichen. Es stimmt mit der 2. Unterliste überein.