catch: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Text replacement - "<code>([^\[]+)<\/code>" to "<sqf>$1</sqf>")
(48 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command


| arma1 |Game name=
|game1= arma1
|version1= 1.00


|gr1= Program Flow |GROUP1=
|game2= arma2
|version2= 1.00


|game3= arma2oa
|version3= 1.50


|game4= tkoh
|version4= 1.00


|1.00|Game version=
|game5= arma3
|version5= 0.50


| Processes code when an [[Exception handling|exception]] is thrown in a [[try]] block. The exception caught can be found in the ''_exception'' variable. |DESCRIPTION=
|gr1= Program Flow


| tryBlock [[catch]] code |SYNTAX=
|descr= Processes code when an [[Exception handling|exception]] is thrown in a [[try]] block. The exception caught can be found in the ''_exception'' variable.


|p1= tryBlock: [[Exception handling|Exception Type]] |PARAMETER1=
|s1= tryBlock [[catch]] code


|p2= code: [[Code]] |PARAMETER2=
|p1= tryBlock: [[Exception handling|Exception Type]]


| [[Anything]] |RETURNVALUE=
|p2= code: [[Code]]


|x1= <code>[[try]] {[[throw]] "invalid argument"} [[catch]] {[[hint]] [[str]] _exception};</code> |EXAMPLE1=
|r1= [[Anything]]


|x2= {{Since|arma3|1.53.133045}}: <code>123 [[try]] {[[if]] (_this != 123) [[throw]] "invalid argument"} [[catch]] {[[hint]] [[str]] _exception};</code> |EXAMPLE2=
|x1= <sqf>try {throw "invalid argument"} catch {hint str _exception};</sqf>


|x3= The correct usage of shorthand alt syntax: <code>[[try]] {
|x2= <sqf>123 try {if (_this != 123) throw "invalid argument"} catch {hint str _exception};</sqf>
[[if]] (a > b) [[throw]] "Error: some error"; {{cc|OK}}
 
{{cc|The command argument is static}}
|x3= The correct usage of shorthand alt syntax:
} [[catch]] {
<sqf>try {
[[hint]] [[str]] _exception;
if (a > b) throw "Error: some error"; // OK
// The command argument is static
} catch {
hint str _exception;
};
};


[[try]] {
try {
_someFunc = {
_someFunc = {
.....
.....
};
};
[[if]] (a > b) [[throw]] ([[call]] _someFunc); {{cc|NOT OK}}
if (a > b) throw (call _someFunc); // NOT OK
{{cc|The command argument is dynamic}}
// The command argument is dynamic
{{cc|_someFunc is called first to get the value regardless of (a > b) outcome}}
// _someFunc is called first to get the value regardless of (a > b) outcome
} [[catch]] {
} catch {
[[hint]] [[str]] _exception;
hint str _exception;
};
};


[[try]] {
try {
_someFunc = {
_someFunc = {
.....
.....
};
};
[[if]] (a > b) [[then]] {[[throw]] ([[call]] _someFunc)}; /// OK
if (a > b) then {throw (call _someFunc)}; /// OK
{{cc|The command argument is dynamic}}
// The command argument is dynamic
{{cc|_someFunc is only called when (a > b) is [[true]]}}
// _someFunc is only called when (a > b) is true
} [[catch]] {
} catch {
[[hint]] [[str]] _exception;
hint str _exception;
};</code> |EXAMPLE3=
};</sqf>


| [[Exception handling]], [[try]], [[throw]] |SEEALSO=
|seealso= [[Exception handling]] [[try]] [[throw]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Revision as of 21:08, 13 May 2022

Hover & click on the images for description

Description

Description:
Processes code when an exception is thrown in a try block. The exception caught can be found in the _exception variable.
Groups:
Program Flow

Syntax

Syntax:
tryBlock catch code
Parameters:
tryBlock: Exception Type
code: Code
Return Value:
Anything

Examples

Example 1:
try {throw "invalid argument"} catch {hint str _exception};
Example 2:
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 handling try throw

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