member()

Zusammenfassung

Gibt True zurück, wenn sich das Element in der Liste befindet. Die Liste muss nicht homogen sein und kann Elemente mit beliebigen Typen enthalten.

Syntax

member ( item As Any, _
         list As List, _
         Optional key As Name = :Identity, _
         Optional test As Name = :Equal ) As Boolean 

Argument	Typ	Beschreibung
item	Any	Das Element, dessen Listenzugehörigkeit überprüft werden soll. Dieses Argument darf auch NoValue sein.
list	List	Eine Liste mit Elementen
key	Name	Optional. Der Name der Funktion, die für jedes Element der Liste aufgerufen werden soll. Vorgabe ist :Identity.
test	Name	Optional. Der Name der Testfunktion, die auf die Ergebnisse von key aus der Liste angewendet werden soll. Vorgabe ist :Equal.

Beispiel 1

Intent >member(3, {7, 4, 3, 9, 0}) 
--> True 

Beispiel 2

Intent >member(3, {7, 4, 9, 0}) 
--> False 

Beispiel 3

Intent >member(3, {7, 4, 9, 0}, test := :sameType?) 
--> True 

Zum Überprüfen der Listenzugehörigkeit können Sie auch eine andere Funktion aufrufen. Die Vorgabe ist :Equal, aber Sie können den Test mit der folgenden benutzerdefinierten Funktion auch bezogen auf den Typ der Listenelemente durchführen, anstatt auf die Gleichheit der Listenelemente.

Function sameType?(I As Any, j As Any) As Boolean 
    sameType? = (typeName(i) = typeName(j)) 
End Function 

Beispiel 4

Intent >member(3, {a, b, c, d}, test := :sameType?) 
--> False 

Auch dieses Beispiel verwendet die benutzerdefinierte Funktion des vorherigen Beispiels.

Beispiel 5

Intent >member(2, {"a", "bcd", "ef", "ghi"}, key := :length) 
--> True 

Gibt True zurück, weil eines der Listenelemente (ef) die Länge 2 hat.