setlocal
DESTINATION
,
FORMULA
The setlocal statement sets a value into a local variable. The name of the local variable is calculated on the fly.
Parameters
This statement has two parameters:
destination – is a formula that calculates the name of the local variable that you want to modify.
formula – calculates the value that will be placed into the destination local variable.
Description
This statement sets a value into a local variable. The name of the local variable is calculated on the fly.
setlocal datepattern( today(),"DayOfWeek"),DepartureTime
Here is the same procedure rewritten without using the setlocal statement. This illustrates the power of the setlocal statement, which in this case is doing the same work as 17 statements.
local Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday
local dayName
dayName=datepattern( today(),"DayOfWeek")
case dayName="Sunday"
Sunday=DepartureTime
case dayName="Monday"
Monday=DepartureTime
case dayName="Tuesday"
Tuesday=DepartureTime
case dayName="Wednesday"
Wednesday=DepartureTime
case dayName="Thursday"
Thursday=DepartureTime
case dayName="Friday"
Friday=DepartureTime
case dayName="Saturday"
Saturday=DepartureTime
endcase
See Also
- assign -- assigns a value to a field or variable.
- assignfield -- performs an assignment, much like an equals sign or the assign statement. However, the *assignfield* statement only performs the assignment to a database field, not to any variable.
- assignfieldwithsideeffects -- performs an assignment, much like an equals sign or the assign statement. However, the *assignfieldwithsideeffects* statement only performs the assignment to a database field, not to any variable. After performing the assignment, it will run any side effects associated with the field, including formulas and code associated with the field.
- assignfileglobal -- performs an assignment, much like an equals sign or the assign statement. However, the *assignfileglobal* statement only performs the assignment to a fileglobal variable.
- assignglobal -- performs an assignment, much like an equals sign or the assign statement. However, the *assignglobal* statement only performs the assignment to a global variable.
- assignlocal -- performs an assignment, much like an equals sign or the assign statement. However, the *assignlocal* statement only performs the assignment to a local variable.
- assignwindowglobal -- performs an assignment, much like an equals sign or the assign statement. However, the *assignwindowglobal* statement only performs the assignment to a windowglobal variable.
- define -- performs an assignment, much like an equals sign or the assign statement. However, the *define* statement only performs the assignment if the variable is currently undefined. If the variable already has a value, the *define* statement leaves it alone. The *define* statement is especially useful for initializing permanent variables.
- let -- creates a local variable and assigns a value to it.
- letfileglobal -- creates a fileglobal variable and assigns a value to it.
- letglobal -- creates a global variable and assigns a value to it.
- letpermanent -- creates a permanent variable and assigns a value to it.
- letservervariable -- creates a server variable and assigns a value to it.
- letwindowglobal -- creates a windowglobal variable and assigns a value to it.
- set -- performs an assignment, much like an equals sign or the assign statement. However, the destination of the assignment can be calculated on the fly.
- setfield -- performs an assignment, much like an equals sign or the assign statement. However, the destination field of the assignment can be calculated on the fly.
- setglobal -- sets a value into a global variable. The name of the global variable is calculated on the fly.
- setlocalsfromdictionary -- converts a dictionary into a collection of local variables. The names and values of the local variables will be derived from the dictionary contents.
History
| 10.0 | New | New in this version. |