find()

Zusammenfassung

Gibt den Artikel, die die Suchkriterien erfüllt, die aus einer list . In der einfachsten Form wird das erste Element 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

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

Argument	Typ	Beschreibung
item	Any	Der gesuchte Wert
inList	List	List des Kandidaten. Nur das erste übereinstimmende Element wird zurückgegeben.

Optionale Argumente

Name	Typ	Vorgabewert	Beschreibung
key	Any	Identity	Optional. Der Name der Funktion auf jeden Eintrag der Liste inList angewendet, um vor dem Vergleich. 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 verglichen, um nur die erste Profilelement der Listen in inList. 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"}