execute

Executes a command on the front-end platform, with or without waiting.

Syntax

ui.Interface.frontCall("standard", "execute",
 [cmd,wait], [result])
  1. command - The command to be executed.
  2. wait - The wait option (TRUE=wait, FALSE=do not wait).
  3. result - The execution status (TRUE=success, FALSE=error).

Usage

The "execute" front call runs a command on the front-end platform, with or without waiting option.

Tip: When specifying a file path, pay attention to platform specific rules regarding directory separators and space characters in file names. When the front-end executes on a recent Microsoft™ Windows™ system, you can use the / slash character as directory separator, like on Unix systems. A directory or file name can contain spaces, and there is no need to surround the path with double quotes in such case. When using backslash directory separators, make sure to escape backslash characters in string literals with \\.

If the second parameter is set to TRUE, the runtime system will wait until the front-end gives the control back after the local command was executed.

Tip: With the front-end running on Microsoft Windows systems platforms, depending on the program to be executed, you may need to add the "cmd /C" command before the executable name and program arguments.

Example

For Microsoft Windows system:

-- Using backslash as directory separator:
CALL ui.Interface.frontCall("standard", "execute",
     ["C:\\Program Files\\FourJS\\gdc\\3.10\\bin\\gdc.exe --help",FALSE], [res] )

-- Using slash as directory separator:
CALL ui.Interface.frontCall("standard", "execute",
     ["C:/Program Files/FourJS/gdc/3.10/bin/gdc.exe --help",FALSE], [res] )