abort: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Corrected capitilization in function name.)
(Added function type category.)
Line 20: Line 20:
</source>
</source>
}}
}}
[[Category:Miscellaneous Function]]

Revision as of 21:44, 6 March 2009

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)]