catch: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (+ category)
m (Text replacement - "↵↵</sqf>" to " </sqf>")
 
(81 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


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


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Processes code when an [[Exception_Type|exception]] is thrown in a [[try]] block. The exception caught can be found in the _exception variable. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| try-block '''catch''' code |= Syntax
|game4= tkoh
|version4= 1.00


|p1= try-Block [[]] |= Parameter 1
|game5= arma3
|version5= 0.50


|p2= code [[Code]] |= Parameter 2
|gr1= Program Flow


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


| [[Exception handling]] |= See also
|s1= tryBlock [[catch]] code


}}
|p1= tryBlock: [[Exception handling|Exception Type]]
 
|p2= code: [[Code]]
 
|r1= [[Anything]]
 
|x1= <sqf>try { throw "invalid argument" } catch {hint str _exception};</sqf>
 
|x2= <sqf>123 try { if (_this != 123) throw "invalid argument" } catch { hint str _exception };</sqf>


<h3 style="display:none">Notes</h3>
|x3= The correct usage of shorthand alt syntax:
<dl class="command_description">
<sqf>
<!-- Note Section BEGIN -->
try {
if (a > b) throw "Error: some error"; // OK
// the command argument is static
} catch {
hint str _exception;
};


<!-- Note Section END -->
try {
</dl>
_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;
};


<h3 style="display:none">Bottom Section</h3>
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;
};
</sqf>


[[Category:Scripting Commands|CATCH]]
|seealso= [[Exception handling]] [[try]] [[throw]]
[[Category:Scripting Commands ArmA|CATCH]]
}}
[[Category:Armed Assault: Control Flows|CATCH]]
[[Category:Command Group: Program Flow|CATCH]]

Latest revision as of 19:48, 3 September 2024

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