find()

Zusammenfassung

Gibt das Element einer Liste zurück, das mit den Suchkriterien übereinstimmt. In seiner einfachsten Form gibt diese Funktion das erste Element der Liste inList zurück, das mit item übereinstimmt. 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 zurückgegeben.

Syntax

find ( item As Any, _
       inList As List, _
       Optional key As Any ) As Any 

Argument	Typ	Beschreibung
item	Any	Der gesuchte Wert
inList	List	Liste der zu durchsuchenden Elemente. Nur das erste übereinstimmende Element wird zurückgegeben.

Optionale Argumente

Name	Typ	Vorgabewert	Beschreibung
key	Any	Identity	Optional. Der Name der Funktion, der vor dem Vergleich auf jeden Eintrag der Liste inList angewendet werden soll. Vorgabe ist :Identity.

Beispiel 1

Intent >find(3, {1, 2, 3}) 
--> 3 

Beispiel 2

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

Beispiel 3

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

In diesem Beispiel wird item nur mit dem ersten Eintrag jeder der in inList enthaltenen Listen verglichen. Beachten Sie, dass nur die erste Übereinstimmung zurückgegeben wurde.

Beispiel 4

Intent >find("mary", {"peter", "paul", "mary"}) 
--> "mary" 

Beispiel 5

Intent >find(3, {{2, "lm"}, {3, "pq"}, {4, "xy"}}, key := :first) 
--> {3, "pq"}