throw: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[[cC]ategory:[sS]cripting [cC]ommands\|[a-z A-Z 0-9_]+\]\]" to "")
m (Text replacement - "\{\{( *)Important( *)\|" to "{{$1Feature$2|$2important$2|")
Line 9: Line 9:
| Throws an exception. The exception is processed by first [[catch]] block. This command will terminate further execution of the code.
| Throws an exception. The exception is processed by first [[catch]] block. This command will terminate further execution of the code.


{{Important | Avoid using alternative shorthand syntax if you are planning on preparing your exception information dynamically, as it will have to be generated first regardless of the condition of the [[if]] statement before it, as shown in Example 3.}}
{{Feature | important | Avoid using alternative shorthand syntax if you are planning on preparing your exception information dynamically, as it will have to be generated first regardless of the condition of the [[if]] statement before it, as shown in Example 3.}}


|s1= [[throw]] expression
|s1= [[throw]] expression

Revision as of 02:11, 7 February 2021

Hover & click on the images for description

Description

Description:
Description needed
Groups:
Program Flow

Syntax

Syntax:
throw expression
Parameters:
expression: Anything
Return Value:
Nothing

Alternative Syntax

Syntax:
if (condition) throw exception Template:Since
Parameters:
if (condition): If Type - if (condition) returns true, "exception" is thrown
exception: Anything - value that will be put into _exception variable inside catch block
Return Value:
Nothing

Examples

Example 1:
try {throw "invalid argument"} catch {hint str _exception};
Example 2:
Template:Since: 123 try {if (_this != 123) throw "invalid argument"} catch {hint str _exception};
Example 3:
The correct usage of shorthand alt syntax: try { if (a > b) throw "Error: some error"; // OK // The command argument is static } catch { hint str _exception; }; try { _someFunc = { ..... }; if (a > b) throw (call _someFunc); // NOT OK // The command argument is dynamic // _someFunc is called first to get the value regardless of (a > b) outcome } catch { hint str _exception; }; try { _someFunc = { ..... }; if (a > b) then {throw (call _someFunc)}; /// OK // The command argument is dynamic // _someFunc is only called when (a > b) is true } catch { hint str _exception; };

Additional Information

See also:
Exception handlingtrycatch

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note