exit

Typecontrol structure
DictionaryLCS
LibraryLiveCode Script
Syntax
exit <handler>
Summary

Stops execution of a handler.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
handler

The name of the handler in which the exit control structure appears.

Example
if the seconds > timeLimit then exit mouseUp
setProp myCustomProperty pValue
   -- can be used in getProp or setProp handlers
   exit myCustomProperty
end myCustomProperty
RelatedConstant: return
Command: call
Function: commandNames
Control Structure: getProp, return, setProp, if, pass, break, on, exit to top, exit repeat, function
Glossary: object, function handler, return, message handler, setProp handler, pass, execute, function call, command, control structure, getProp handler, trigger, getProp call, caller, message path, message, statement, handler
Description

Use the exit control structure to skip the rest of a handler's statements without returning a result.

Form: The exit statement appears on a line by itself, anywhere inside a handler.

You can use an exit control structure in a message handler, function handler, getProp handler, or setProp handler. Usually, exit is used within an if control structure, so that the handler stops if a condition is true and continues if the condition is false.

If the current handler was called from another handler, the calling handler continues executing. The exit statement only stops the current handler, not the calling handler. (To stop all pending handlers, use the exit to top control structure.)

When a handler executes an exit statement, the message, trigger, function call, or getProp call stops and is not passed to the next object in the message path. To halt the current handler and pass the message, trigger, or call on through the message path, use the pass control structure instead. To halt the current handler and return a result, use the return controlstructure instead.

Note: The exit control structure is implemented internally as a command and appears in the commandNames.