throw: Difference between revisions
Jump to navigation
Jump to search
m (Text replacement - "<h3 style="display:none">Bottom Section</h3> " to "") |
Lou Montana (talk | contribs) m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame( +[0-9])?|Game [Vv]ersion( +[0-9])?|Game Version \(number surrounded by NO SPACES\)|Arguments in MP|MP[Aa]rg|Multiplayer Arguments( \("local" or "global"\))?|Effects|Execution|Effects...) |
||
| Line 1: | Line 1: | ||
{{Command | {{Command | ||
| arma1 | | arma1 | ||
|gr1= Program Flow | |gr1= Program Flow | ||
|1.00 | |1.00 | ||
| 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.}} | {{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 | ||
|p1= expression: [[Anything]] | |p1= expression: [[Anything]] | ||
|r1= [[Nothing]] | |r1= [[Nothing]] | ||
|s2= if (condition) [[throw]] exception {{Since|arma3|1.53.133045|y}} | |s2= if (condition) [[throw]] exception {{Since|arma3|1.53.133045|y}} | ||
|p21= if (condition): [[If Type]] - if (condition) returns [[true]], "exception" is thrown |PARAMETER21= | |p21= if (condition): [[If Type]] - if (condition) returns [[true]], "exception" is thrown |PARAMETER21= | ||
|p22= exception: [[Anything]] - value that will be put into ''_exception'' variable inside [[catch]] block|PARAMETER22= | |p22= exception: [[Anything]] - value that will be put into ''_exception'' variable inside [[catch]] block|PARAMETER22= | ||
|r2= [[Nothing]] | |r2= [[Nothing]] | ||
|x1= <code>[[try]] {[[throw]] "invalid argument"} [[catch]] {[[hint]] [[str]] _exception};</code> | |x1= <code>[[try]] {[[throw]] "invalid argument"} [[catch]] {[[hint]] [[str]] _exception};</code> | ||
|x2= {{Since|arma3|1.53.133045}}: <code>123 [[try]] {[[if]] (_this != 123) [[throw]] "invalid argument"} [[catch]] {[[hint]] [[str]] _exception};</code> | |x2= {{Since|arma3|1.53.133045}}: <code>123 [[try]] {[[if]] (_this != 123) [[throw]] "invalid argument"} [[catch]] {[[hint]] [[str]] _exception};</code> | ||
|x3= The correct usage of shorthand alt syntax: <code>[[try]] { | |x3= The correct usage of shorthand alt syntax: <code>[[try]] { | ||
| Line 55: | Line 55: | ||
} [[catch]] { | } [[catch]] { | ||
[[hint]] [[str]] _exception; | [[hint]] [[str]] _exception; | ||
};</code> | };</code> | ||
|seealso= [[Exception handling]], [[try]], [[catch]] | |seealso= [[Exception handling]], [[try]], [[catch]] | ||
Revision as of 11:23, 18 January 2021
Description
- Description:
- Throws an exception. The exception is processed by first catch block. This command will terminate further execution of the code.
- Groups:
- Program Flow
Syntax
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