Control Structures

require

Supported By

Syntax

require scriptName [once] [(with|without) dialog]

ScriptName yields the name or path of an XION script file.

Description

The require statement executes the statements contained in an XION script file. If the script file cannot be found, the user will be asked to locate it, unless the without dialog keyword is used. If the script file cannot be found and the user cancels or the without dialog keyword is used, the require statement triggers a script error. (For a version that does not trigger a script error, see include.) If the once keyword is used and the script has been executed before, it will not be executed again.

In OpenXION, the locations searched for included scripts are determined by the includePaths property.

Note

The require statement as described here is specific to OpenXION.

See Also

include, includePaths, includePath, includeFile