Difference between revisions of "catch"

From Bohemia Interactive Community
Jump to navigation Jump to search
m
 
m (Text replacement - "Category:Scripting Commands ArmA2" to "Category:Scripting Commands Arma 2")
 
(27 intermediate revisions by 12 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|CATCH]]
+
{{Command|Comments=
[[Category:Scripting Commands ArmA|CATCH]]
+
____________________________________________________________________________________________
  
 +
| arma |Game name=
  
<h2 style="color:#000066">'''''try-block'' catch ''filename'''''</h2>
+
|1.00|Game version=
 +
____________________________________________________________________________________________
  
 +
| Processes code when an [[Exception handling|exception]] is thrown in a [[try]] block. The exception caught can be found in the ''_exception'' variable. |DESCRIPTION=
 +
____________________________________________________________________________________________
  
'''Operand types:'''
+
| tryBlock [[catch]] code |SYNTAX=
  
'''try-Block''':
+
|p1= tryBlock: [[Exception handling|Exception Type]] |PARAMETER1=
  
'''code''': [[Code]]
+
|p2= code: [[Code]] |PARAMETER2=
  
'''Type of returned value:'''
+
| [[Anything]] |RETURNVALUE=
 +
____________________________________________________________________________________________
  
[[Anything]]
+
|x1= <code>[[try]] {[[throw]] "invalid argument"} [[catch]] {[[hint]] [[str]] _exception};</code> |EXAMPLE1=
  
'''Compatibility:'''
+
|x2= {{since|arma3|1.53.133045}}: <code>123 [[try]] {[[if]] (_this != 123) [[throw]] "invalid argument"} [[catch]] {[[hint]] [[str]] _exception};</code> |EXAMPLE2=
  
2.x
+
|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;
 +
};
  
'''Description:'''
+
[[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;
 +
};
  
Processes code, when exception is thrown in try block.
+
[[try]] {
 +
_someFunc = {
 +
.....
 +
};
 +
[[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> |EXAMPLE3=
 +
 
 +
| [[Exception handling]], [[try]], [[throw]] |SEEALSO=
 +
}}
 +
 
 +
<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}}}}]]
 +
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Command Group: Program Flow|{{uc:{{PAGENAME}}}}]]

Latest revision as of 00:10, 10 January 2020

Introduced with Armed Assault version 1.001.00
Hover & click on the images for descriptions

Description

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

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:
since Arma 3 v1.53.133045: 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

i
Only post proven facts here. Report bugs on the feedback tracker. Use the Talk page or the Forums for discussions.

Notes

Bottom Section