Error getting tags :
error 404Error getting tags :
error 404 local | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Version
local
Basics
Expander triangle
Type
Command
Syntax

local variablesList

Introduced
1.0
Environment
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Security
None required
Summary
Declares one or more local variables and assigns initial values to them.
Examples

local currentStatus -- creates one local variable
local thisThing,thatThing,theOtherThing -- creates three variables
local A=1,B=2,C=3 -- creates variables with initial values
-- To make a numbered list of variables:
repeat with x=1 to 20
do "local tVar_" & x &" tVar_" tVar_" tVar_" & x
end repeat

Additional Comments
Expander triangle

Use the local command to define a local variable for a handler, or to define a script local variable that is shared between all the handlers in a script.

Parameters:

The variablesList consists of one or more name=value pairs, separated by commas:

* The name is any string.

* The value is any literal string.

The value is optional; you can specify just the variable name. In this case, the specified local variables contain empty when created.

Comments:

The local declaration is optional. You can use a local variable without declaring it first in the handler. In this case, the local variable can be used only within that handler.

The local command can appear anywhere in a handler. However, variable declarations are usually placed at the beginning of a handler. This makes them easier to find and as local variables are created at the point in the script where they are declared it will ensure the variable isn't used before the declaration.

You can also use the local command to create a script local variable. Script local variables can be used by any handler in that script, without needing to be declared in the handler itself, and their values are maintained from handler to handler. You create a script local variable by using the local command in a script, outside any handlers in the script. (The difference between a script local variable and a global variable is that a script local variable can only be used in the handlers of one script, while a global variable can be used in any handler or script with a global declaration for that variable.)

The value of a local variable is retained only while the handler is running. When the handler exits, the value of the local variable is lost.

The value of a script local variable is retained between handlers, but is lost when you quit the application, when you close the stack (unless its destroyStack property is false). If variable preservation is turned on, script locals retain their values when the script is re-compiled, unless there is an error in the script. With variable preservation turned off, script locals lose their values when the script is recompiled.

User Comments
Expander triangle