catch: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "\| *((\[\[.*\]\],? ?)+) * \}\}" to "|seealso= $1 }}")
(28 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
| arma1


|1.00|= Game version
|gr1= Program Flow
____________________________________________________________________________________________


| Processes code when an [[Exception handling|exception]] is thrown in a [[try]] block. The exception caught can be found in the _exception variable. |= Description
|1.00
____________________________________________________________________________________________


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


|p1= try-Block [[Exception handling|Exception Type]] |= Parameter 1
| tryBlock [[catch]] code


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


| [[Anything]] |= Return value
|p2= code: [[Code]]
____________________________________________________________________________________________


| [[Exception handling]] |= See also
| [[Anything]]


}}
|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>
 
|x3= The correct usage of shorthand alt syntax: <code>[[try]] {
[[if]] (a > b) [[throw]] "Error: some error"; {{cc|OK}}
{{cc|The command argument is static}}
} [[catch]] {
[[hint]] [[str]] _exception;
};
 
[[try]] {
_someFunc = {
.....
};
[[if]] (a > b) [[throw]] ([[call]] _someFunc); {{cc|NOT OK}}
{{cc|The command argument is dynamic}}
{{cc|_someFunc is called first to get the value regardless of (a > b) outcome}}
} [[catch]] {
[[hint]] [[str]] _exception;
};


<h3 style="display:none">Notes</h3>
[[try]] {
<dl class="command_description">
_someFunc = {
<!-- Note Section BEGIN -->
.....
};
[[if]] (a > b) [[then]] {[[throw]] ([[call]] _someFunc)}; /// OK
{{cc|The command argument is dynamic}}
{{cc|_someFunc is only called when (a > b) is [[true]]}}
} [[catch]] {
[[hint]] [[str]] _exception;
};</code>


<!-- Note Section END -->
|seealso= [[Exception handling]], [[try]], [[throw]]
</dl>
}}


<h3 style="display:none">Bottom Section</h3>


[[Category:Scripting Commands|CATCH]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|CATCH]]
{{GameCategory|arma1|Scripting Commands}}
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma2|Scripting Commands}}
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma3|Scripting Commands}}
[[Category:ArmA: Control Structures|CATCH]]
{{GameCategory|tkoh|Scripting Commands}}
[[Category:Command Group: Program Flow|CATCH]]

Revision as of 00:22, 17 February 2021

Hover & click on the images for description

Description

Description:
Description needed
Groups:
Program Flow

Syntax

Syntax:
Syntax needed
Parameters:
tryBlock: Exception Type
code: Code
Return Value:
Return value needed

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 handlingtrythrow

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