apply()

Zusammenfassung

Führt die jeweilige Funktion mit den angegebenen Argumenten aus. Das letzte Argument muss eine Liste sein, und die Elemente der Liste werden für die Funktion einzeln angegeben. Die direkt angegebenen Argumente (nach der Funktion) werden in der Regel für erforderliche Argumente für die Funktion verwendet, während das letzte Listen argument eine einfache Methode ist, um optionale Argumente anzugeben. Es können aber auch, falls gewünscht, alle Argumente in einer einzigen Liste angegeben werden (siehe Beispiele unten). Diese Funktion wird in der Regel verwendet, wenn es Code gibt, der zur Laufzeit entscheiden muss, welche von mehreren Funktionen ausgeführt werden sollen.

Syntax

apply ( function As Name, _
        args... As Any ) As Any 

Argument	Typ	Beschreibung
function	Name	Der Name der anzuwendenden Funktion.
args	Alle	Argumente für die angewendete Funktion (das letzte Argument muss eine Liste sein.)

Beispiel 1

Intent >apply(:min, {3.0, 4.5, 1.5, 7.3}) 
--> 1.5 

In diesem Beispiel wird die Funktion min() auf eine Reihe von Argumenten angewendet. Diese können entweder als einzelnes Argument (eine Liste mit Werten) oder als separate Argumente (solange das letzte Argument eine Liste ist) angegeben werden. Die nächsten beiden Beispiele führen zum gleichen Ergebnis.

Beispiel 2

Intent >apply(:min, 3.0, 4.5, {1.5, 7.3}) 
--> 1.5 

Beispiel 3

Intent >apply(:min, 3.0, 4.5, 1.5, 7.3, {}) 
--> 1.5 

Beispiel 4

Intent >apply(:myFunc, {2, 3}) 
--> True 

In diesem Beispiel wurde die folgende benutzerdefinierte Funktion myFunc() auf die Liste mit zwei Zahlen angewendet.

Function myFunc(Number x, Number y) As Boolean 
    myFunc = x < y 
End Function