Home | Categories | Alphabetical | Classes | All Contents | [ < ] | [ > ]

EXECUTE


Syntax | Return Value | Arguments | Keywords | Examples | Version History | See Also

The EXECUTE function compiles and executes one or more IDL statements contained in a string at run-time.

Warning
Use of the EXECUTE function is not permitted when IDL is in Virtual Machine mode.

Like the CALL_PROCEDURE and CALL_FUNCTION routines, calls to EXECUTE can be nested. However, compiling the string at run-time is inefficient. CALL_FUNCTION and CALL_PROCEDURE provide much of the functionality of EXECUTE without imposing this limitation, and should be used instead of EXECUTE whenever possible.

Syntax

Result = EXECUTE(String [, QuietCompile] [, QuietExecution])

Return Value

EXECUTE returns true (1) if the string was successfully compiled and executed. If an error occurs during either phase, the result is false (0).

Arguments

String

A string containing the command(s) to be compiled and executed.

QuietCompile

If this argument is set to a non-zero value, EXECUTE will not print the compiler generated error messages (such as syntax errors). If QuietCompile is omitted or set to 0, EXECUTE will output such errors.

QuietExecution

If this argument is set to a non-zero value, EXECUTE will not print error messages generated during execution. If QuietExecution is omitted or set to 0, EXECUTE will output such errors.

Keywords

None.

Examples

Create a string that holds a valid IDL command and execute the command by entering:

com = 'PLOT, [0,1]' 
void = EXECUTE(com) 

Version History

Introduced: Original

QuietCompile argument: IDL 5.2

QuietExecution argument: IDL 6.1

Execute the contents of the string by entering:

R = EXECUTE(com) 

A plot should appear. You can confirm that the string was successfully compiled and executed by checking that the value of R is 1.

Version History

Introduced: Original

See Also

CALL_FUNCTION, CALL_METHOD, CALL_PROCEDURE


Home | Categories | Alphabetical | Classes | All Contents | [ < ] | [ > ]