abort

From RPTools Wiki
Revision as of 21:44, 6 March 2009 by Verisimilar (talk | contribs) (Added function type category.)
Jump to navigation Jump to search

abort() Function

Aborts the execution of the current macro and discards all output from the macro if the argument is 0. This function is generally used to abort the processing of a macro if user clicks on the cancel button on a dialog created with the input() function. Any properties set before the abort will contain the values you set them to. That is abort(0) will not undo any changes you made

Usage

[h: abort(num)]

Examples

The following example will create a dialog box for the user to enter a value for the variable named blah, if the user clicks on cancel then res will be 0 so the abort() function will cause the macro to terminate, otherwise res will not be 0 so the macro will continue.
[h: res = input("blah")] [h: abort(res)]

This example discards any output in the macro.

Hah! you will never see this! [abort(0)]