SetzeVar

Setzt eine Variable bzw. Variablen für die Dauer der Berechnung bzw. bis das Scripts verlassen oder die Datei geschlossen wird, auf das Ergebnis des angegebenen Ausdruck.

Format 

SetzeVars ( {[} Var1 = Ausdruck1 {; Var2 = Ausdruck2...]} ; Rechenanweisung )

Parameter 

var - beliebiger Variablenname. (Weitere Informationen finden Sie unter Verwenden von Variablen.)

Ausdruck - beliebiger Rechenausdruck, Feld oder Konstante.

Rechenanweisung - beliebiger Rechenausdruck, Feld oder Konstante.

Parameter in geschweiften Klammern { } sind optional.

Zurückgegebener Datentyp 

Text, Zahl, Datum, Zeit, Zeitstempel, Container

Ursprung in Version 

7.0

Beschreibung 

Mit der Funktion „SetzeVar“ können Sie Variablen die Ergebnisse von Ausdrücken zuweisen und ein Ergebnis zurückgeben, das diese Variablen verwenden kann. Verwenden Sie die Funktion „SetzeVar“, um komplexe Formeln lesbarer zu gestalten, indem Sie den Aufruf von Funktionen innerhalb von Funktionen reduzieren. Die Funktion „SetzeVar“ kann Formeln auch effizienter machen, indem das Ergebnis der Funktionsaufrufe in Variablen gespeichert wird, die innerhalb der Formel wiederverwendbar sind, wodurch sich die Anzahl der redundanten Funktionsaufrufe verringert.

Um in einer Funktion „SetzeVar“ mehrere Variablen zuzuweisen, verwenden Sie eine Listensyntax in eckigen Klammern [ ] und durch Semikolons getrennt. Zur leichteren Lesbarkeit mehrerer Variablen können Sie jede Variable und die zurückgegebene Berechnung in separate Zeilen setzen, obwohl diese Formatierung nicht erforderlich ist. Beispiel:

Kopieren
SetzeVar ( [
    Variable = Wert ;
    Variable2 = Wert2
] ;
Berechnung )

Die Funktion „SetzeVar“ setzt die Variablen von links nach rechts. Sie können zuvor definierte Variablen (z. B. Funktionsvariablen aus der Funktion „SetzeVar“ oder lokale und globale Variablen aus dem Scriptschritt „Variable setzen“) verwenden, um neue Variablenwerte zu definieren.

Sie können auch SetzeVar-Funktionen verschachteln. Wenn Sie eine zuvor definierte Funktionsvariable in einer verschachtelten Funktion „SetzeVar“ verwenden, gilt diese Funktionsvariable nur für den Umfang der verschachtelten Funktion (als hätten Sie eine vollständig neue Variable definiert). Siehe Beispiel 2 unten.

Sobald sie definiert sind, können Variablen in jeder Formel innerhalb ihres Geltungsbereichs referenziert werden. Lokale Variablen, die in einer Formel definiert sind, haben die Datei als Geltungsbereich, stehen aber nur zur Verfügung, wenn keine Scripts ausgeführt werden. Weitere Informationen finden Sie unter Verwenden von Variablen.

Beispiel 1 

SetzeVar ( x=5 ; x*x ) gibt 25 zurück.

SetzeVar ( [x=5 ; Quadrat=x*x ; Kubik=Quadrat*x] ; Kubik ) gibt 125 zurück.

Beispiel 2

Das folgende Beispiel gibt San Francisco - Paris zurück.

Kopieren
SetzeVar (
    Ort = "Paris" ;
    SetzeVar (
        Ort = "San Francisco" ;
        Ort & "-"
    )
& Ort )

Beispiel 3 

In diesem Beispiel wird eine lokale Variable in die Berechtigung des aktuellen Kontozugriffs gesetzt und der Inhalt der Variablen zurückgegeben. Wenn diese Formel in einem Script verwendet wird, wäre die lokale Variable für die Dauer des Scripts verfügbar.

SetzeVar ( $BERECHTIGUNG = Hole ( KontoBerechtigungenName ) ; $BERECHTIGUNG ) gibt [Full Access] zurück, wenn es von einem Konto mit der Berechtigung „Voller Zugriff“ überprüft wird.

Beispiel 4 

Dieses Beispiel setzt eine lokale Variable Zähler bei Wiederholung 50 mit einem Wert von 120:

SetzeVar ( $Zähler[50] = 120 ; $Zähler[50]*2 ) gibt 240 zurück.

Beispiel 5 

Dieses Beispiel zeigt, wie benannte Parameter mithilfe der Funktionen Berechne, SetzeVar und Hole ( ScriptParameter ) übergeben werden, die nur Zugriff auf die Variable a gestatten (das Beispiel gibt 6 zurück):

ScriptParameter = "a = 5 ; b = 10"

Kopieren
Berechne ( 
    "SetzeVar ( [" 
        & Hole ( ScriptParameter )] & "
    ] ; 
    a+1 )" 
)

Beispiel 6 

Dieses Beispiel zeigt, wie benannte Parameter übergeben werden, wobei der Zugriff sowohl auf die Variable a als auch auf b erlaubt ist. Durch die Vereinfachung des ersten Parameters wird der zweite Parameter komplexer (das Beispiel gibt 6, 12 zurück):

ScriptParameter = "a = 5 ; b = 10"

Kopieren
Berechne ( 
    "SetzeVar ( ["
        & Hole ( ScriptParameter )] & "
    ] ;
    a+1 & \", \" & b+2 )" 
)

Beispiel 7 

Dieses Beispiel zeigt, wie benannte Parameter übergeben werden, während die Syntax des zweiten Parameters der Funktion SetzeVar weiterhin geprüft werden kann (das Ergebnis gibt 6, 12 zurück):

ScriptParameter = "a = 5 ; b = 10"

Kopieren
SetzeVar ( [
    a = Berechne ( 
        "SetzeVar ( ["
            & Hole ( ScriptParameter )] & "
        ] ;
        a )" 
    ),
    b = Berechne ( 
        "SetzeVar ( ["
            & Hole ( ScriptParameter )] & "
        ] ;
        b )"
    )
] ; 
a+1 & ", " & b+2 )