Arma 3 Scripting

Command in Program Flow

try

Also available as Markdown and JSON, or read the original wiki page.

Description

Defines a try-catch structure. This sets up an exception handling block. Any thrown exception in a try block is caught in a catch block. The structured exception block has the following form:

try
{ /* block that can throw exception */ }
catch
{ /* block that processes the exception. Exception is described in the _exception variable */ };

Syntax

Syntax 1

try code

Parameters:

Returns: Exception Type

Syntax 2

since arma3 1.54

args try code

Parameters:

Returns: Exception Type

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

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;
};

See also

Exception handling · throw · catch

Community notes

Killzone_Kid

Do not expect this behave like Javascript try catch and ignore all errors. But it does have one useful behaviour. Normally when a runtime error occurs in SQF (unlike when there is compile error) it continues to execute till the end. But if the script is placed in try {} scope and throw is used upon error, the script immediately terminates, exits the try {} scope and enters catch {} scope. This way it is possible to process possible exceptions in civilised manner.