CASE EB-Funktion
Die Funktion CASE
bewertet den Wert des angegebenen Ausdrucks anhand der angegebenen alternativen Optionen und gibt das Ergebnis der ersten Option zurück, die dem Wert des angegebenen Ausdrucks entspricht. Andernfalls wird ein optionales Standardergebnis zurückgegeben, wenn als letztes Argument der aufgerufenen Funktion ein Standardergebnis angegeben wird, dem keine Option vorangestellt ist. Der zurückgegebene Wert kann ein Wert eines beliebigen unterstützten Datentyps sein.
Syntax
CASE (expression, option 1, result 1[, option 2, result 2, …, option N, result N, default result])
Argumente
expression
: Primitiver Datentyp (Boolesch, numerisch oder Text)
Ein gültiger Ausdruck, der einen Wert des primitiven Datentyps zurückgibt.
option 1
: Primitiver Datentyp (Boolesch, numerisch oder Text)
Ein gültiger Ausdruck, der einen Wert desselben primitiven Datentyps als Argument expression
der aufgerufenen Funktion zurückgibt. Dieses Argument ist erforderlich.
result 1
: Beliebige der unterstützten Datentypen
Das zurückgegebene Ergebnis, das der vorherigen Option entspricht. Dieses Argument ist erforderlich.
option N
: Primitiver Datentyp (Boolesch, numerisch oder Text)
Ein gültiger Ausdruck, der einen Wert desselben primitiven Datentyps als Argument expression
der aufgerufenen Funktion zurückgibt. Dieses Argument ist optional.
result N
: Beliebige der unterstützten Datentypen
Das zurückgegebene Ergebnis, das der vorherigen Option entspricht. Dieses Argument ist optional.
default result
: Beliebige der unterstützten Datentypen
Das Ergebnis, das zurückgegeben werden soll, wenn keine Übereinstimmung vorliegt. Dieses Argument ist optional.
Rückgabewerte
Beliebige der unterstützten Datentypen
Der resultierende Wert eines der unterstützten Datentypen.
Anwendungshinweise
Eine Ausnahme wird zur Laufzeit ausgelöst, wenn keine Übereinstimmung vorliegt und kein optionales Standardergebnis definiert ist.
Alle Ergebnisse müssen anhand desselben Datentyps angegeben werden. Eine Ausnahme wird zur Entwurfszeit ausgelöst, wenn die Datentypen der konfigurierten Ergebnisse nicht übereinstimmen.
Wenn der erste Ergebniswert und der zweite Ergebniswert N. des Datentyps Container (Datensatz) oder des Datentyps Datensatzliste sind, enthält das Ergebnis nur die Felder, die in beiden Werten vorhanden sind.
Beispiel
CASE( DATETIMEFORMAT( NOW(), "MM"), "10", "WINTER", "11", "WINTER", "12", "WINTER", "")
gibt die Zeichenfolge „WINTER“ zurück, wenn die aktuelle Anwendungssitzung zwischen Oktober und Dezember liegt. Andernfalls wird eine leere Zeichenfolge zurückgegeben.