throw - Revision history

Lou Montana: Some wiki formatting

2026-01-07T16:33:15Z

Some wiki formatting

← Older revision		Revision as of 18:33, 7 January 2026
Line 20:		Line 20:
	\|descr= Throws an exception. The exception is processed by first [[catch]] block. This command will terminate further execution of the code.		\|descr= Throws an exception. The exception is processed by first [[catch]] block. This command will terminate further execution of the code.

	{{Feature \| important \| Avoid using alternative shorthand syntax if you are planning on preparing your exception information dynamically, as it will have to be generated first regardless of the condition of the [[if]] statement before it, as shown in {{Link\|#Example 3}}.}}		{{Feature\|important\|Avoid using alternative shorthand syntax if you are planning on preparing your exception information dynamically, as it will have to be generated first regardless of the condition of the [[if]] statement before it, as shown in {{Link\|#Example 3}}.}}

	\|s1= [[throw]] ~~expression~~		\|s1= [[throw]] exception

	\|p1= ~~expression~~: [[Anything]]		\|p1= exception: [[Anything]] - value that is put into the <sqf inline>_exception</sqf> variable inside [[catch]] block

	\|r1= [[Nothing]]		\|r1= [[Nothing]]

	\|s2= ~~if (condition)~~ [[throw]] exception		\|s2= ifType [[throw]] exception

	\|s2since= arma3 1.54		\|s2since= arma3 1.54

	\|p21= ~~if (condition)~~: [[If Type]] - if (condition) returns [[true]], "exception" is thrown		\|p21= ifType: [[If Type]] - if the condition returns [[true]], ''exception'' is thrown

	\|p22= exception: [[Anything]] - value that ~~will be~~ put into ''_exception'' variable inside [[catch]] block		\|p22= exception: [[Anything]] - value that is put into the <sqf inline>_exception</sqf> variable inside [[catch]] block

	\|r2= [[Nothing]]		\|r2= [[Nothing]]

	\|x1= <sqf>try {throw "invalid argument"} catch {hint str _exception};</sqf>		\|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>		\|x2= <sqf>123 try { if (_this != 123) throw "invalid argument" } catch { hint str _exception };</sqf>
Line 44:		Line 44:
	\|x3= The correct usage of shorthand alt syntax:		\|x3= The correct usage of shorthand alt syntax:
	<sqf>		<sqf>
	try {		try
	if (a > b) throw "Error: some error"; // OK		{
	// the command argument is static		if (a > b)
	} catch {		throw "Error: some error"; // OK - the command argument is static
			}
			catch
			{
	hint str _exception;		hint str _exception;
	};		};
			</sqf>
	try {		<sqf>
	~~_someFunc =~~ {		try
	~~// ...~~		{
	};		if (a > b)
	if (a > b) throw (call _someFunc); // NOT OK		throw (call _someFunc); // NOT OK - the command argument is dynamic
	~~// The~~ command argument is dynamic		// _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;
	};		};
			</sqf>
	try {		<sqf>
	~~_someFunc =~~ {		try
	~~// ...~~		{
	};		if (a > b) then { throw (call _someFunc) }; // OK - the command argument is dynamic
	if (a > b) then {throw (call _someFunc)}; /// OK
	// the command argument is dynamic
	// _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;
	};		};

BrettMayson at 02:31, 2 January 2026

2026-01-02T02:31:33Z

← Older revision		Revision as of 04:31, 2 January 2026
Line 28:		Line 28:
	\|r1= [[Nothing]]		\|r1= [[Nothing]]

	\|s2= if [[throw]] exception		\|s2= if (condition) [[throw]] exception

	\|s2since= arma3 1.54		\|s2since= arma3 1.54

	\|p21= if: [[If Type]] - if (condition) returns [[true]], "exception" is thrown		\|p21= if (condition): [[If Type]] - if (condition) returns [[true]], "exception" is thrown

	\|p22= exception: [[Anything]] - value that will be put into ''_exception'' variable inside [[catch]] block		\|p22= exception: [[Anything]] - value that will be put into ''_exception'' variable inside [[catch]] block

BrettMayson at 00:29, 2 January 2026

2026-01-02T00:29:01Z

← Older revision		Revision as of 02:29, 2 January 2026
Line 28:		Line 28:
	\|r1= [[Nothing]]		\|r1= [[Nothing]]

	\|s2= if ~~(condition)~~ [[throw]] exception		\|s2= if [[throw]] exception

	\|s2since= arma3 1.54		\|s2since= arma3 1.54

	\|p21= if ~~(condition)~~: [[If Type]] - if (condition) returns [[true]], "exception" is thrown		\|p21= if: [[If Type]] - if (condition) returns [[true]], "exception" is thrown

	\|p22= exception: [[Anything]] - value that will be put into ''_exception'' variable inside [[catch]] block		\|p22= exception: [[Anything]] - value that will be put into ''_exception'' variable inside [[catch]] block

Lou Montana: Fix SQF

2022-11-01T15:51:59Z

Fix SQF

← Older revision		Revision as of 17:51, 1 November 2022
Line 20:		Line 20:
	\|descr= Throws an exception. The exception is processed by first [[catch]] block. This command will terminate further execution of the code.		\|descr= Throws an exception. The exception is processed by first [[catch]] block. This command will terminate further execution of the code.

	{{Feature \| important \| Avoid using alternative shorthand syntax if you are planning on preparing your exception information dynamically, as it will have to be generated first regardless of the condition of the [[if]] statement before it, as shown in Example 3.}}		{{Feature \| important \| Avoid using alternative shorthand syntax if you are planning on preparing your exception information dynamically, as it will have to be generated first regardless of the condition of the [[if]] statement before it, as shown in {{Link\|#Example 3}}.}}

	\|s1= [[throw]] expression		\|s1= [[throw]] expression
Line 33:		Line 33:

	\|p21= if (condition): [[If Type]] - if (condition) returns [[true]], "exception" is thrown		\|p21= if (condition): [[If Type]] - if (condition) returns [[true]], "exception" is thrown

	\|p22= exception: [[Anything]] - value that will be put into ''_exception'' variable inside [[catch]] block		\|p22= exception: [[Anything]] - value that will be put into ''_exception'' variable inside [[catch]] block

Line 39:		Line 40:
	\|x1= <sqf>try {throw "invalid argument"} catch {hint str _exception};</sqf>		\|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>		\|x2= <sqf>123 try { if (_this != 123) throw "invalid argument" } catch { hint str _exception };</sqf>

	\|x3= The correct usage of shorthand alt syntax:		\|x3= The correct usage of shorthand alt syntax:
	<sqf>try {		<sqf>
			try {
	if (a > b) throw "Error: some error"; // OK		if (a > b) throw "Error: some error"; // OK
	// ~~The~~ command argument is static		// the command argument is static
	} catch {		} catch {
	hint str _exception;		hint str _exception;
Line 51:		Line 53:
	try {		try {
	_someFunc = {		_someFunc = {
	.....		// ...
	};		};
	if (a > b) throw (call _someFunc); // NOT OK		if (a > b) throw (call _someFunc); // NOT OK
Line 62:		Line 64:
	try {		try {
	_someFunc = {		_someFunc = {
	.....		// ...
	};		};
	if (a > b) then {throw (call _someFunc)}; /// OK		if (a > b) then {throw (call _someFunc)}; /// OK
	// ~~The~~ command argument is dynamic		// the command argument is dynamic
	// _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;
	};</sqf>		};
			</sqf>

	\|seealso= [[Exception handling]] [[try]] [[catch]]		\|seealso= [[Exception handling]] [[try]] [[catch]]
	}}		}}

Lou Montana: Text replacement - "`([^\[]+)<\/code>" to "$1"`


2022-05-13T19:08:16Z
Text replacement - "<code>([^\[]+)<\/code>" to "<sqf>$1</sqf>"

				
				
				
				
				
				← Older revision
				Revision as of 21:08, 13 May 2022
				
Line 42:
Line 42:



|x3= The correct usage of shorthand alt syntax: |x3= The correct usage of shorthand alt syntax:
<code>try { <sqf>try {
	if (a > b) throw "Error: some error"; // OK 	if (a > b) throw "Error: some error"; // OK
	// The command argument is static 	// The command argument is static
Line 69:
Line 69:
} catch { } catch {
	hint str _exception; 	hint str _exception;
};</code> };</sqf>



|seealso= [[Exception handling]] [[try]] [[catch]] |seealso= [[Exception handling]] [[try]] [[catch]]
}} }}



Lou Montana: Text replacement - "\|x([0-9])= *([^<]*)<\/code>" to "|x$1= $2"

2022-05-13T09:25:50Z
Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>"

				
				
				
				
				
				← Older revision
				Revision as of 11:25, 13 May 2022
				
Line 37:
Line 37:
|r2= [[Nothing]] |r2= [[Nothing]]



|x1= <code>try {throw "invalid argument"} catch {hint str _exception};</code> |x1= <sqf>try {throw "invalid argument"} catch {hint str _exception};</sqf>



|x2= <code>123 try {if (_this != 123) throw "invalid argument"} catch {hint str _exception};</code> |x2= <sqf>123 try {if (_this != 123) throw "invalid argument"} catch {hint str _exception};</sqf>



|x3= The correct usage of shorthand alt syntax: |x3= The correct usage of shorthand alt syntax:



Lou Montana: Text replacement - "([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*)
*<\/code>" to "$1$2$3"

2022-05-12T12:10:37Z
Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "<code>$1$2$3</code>"

				
				
				
				
				
				← Older revision
				Revision as of 14:10, 12 May 2022
				
Line 68:
Line 68:
	// _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> };</code>



|seealso= [[Exception handling]] [[try]] [[catch]] |seealso= [[Exception handling]] [[try]] [[catch]]
}} }}



Lou Montana: Text replacement - "([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*)
*<\/code>" to "$1$2$3"

2022-05-12T12:10:25Z
Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "<code>$1$2$3</code>"

				
				
				
				
				
				← Older revision
				Revision as of 14:10, 12 May 2022
				
Line 68:
Line 68:
	// _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> };</code>



|seealso= [[Exception handling]] [[try]] [[catch]] |seealso= [[Exception handling]] [[try]] [[catch]]
}} }}



Lou Montana: Text replacement - "([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*)
*<\/code>" to "$1$2$3"

2022-05-12T12:10:21Z
Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "<code>$1$2$3</code>"

				
				
				
				
				
				← Older revision
				Revision as of 14:10, 12 May 2022
				
Line 67:
Line 67:
	// The command argument is dynamic 	// The command argument is dynamic
	// _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> };</code>



Lou Montana: Text replacement - "([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*)
*<\/code>" to "$1$2$3"

2022-05-12T12:10:15Z
Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "<code>$1$2$3</code>"

				
				
				
				
				
				← Older revision
				Revision as of 14:10, 12 May 2022
				
Line 66:
Line 66:
	if (a > b) then {throw (call _someFunc)}; /// OK 	if (a > b) then {throw (call _someFunc)}; /// OK
	// The command argument is dynamic 	// The command argument is dynamic
	// _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;

throw - Revision history

Lou Montana: Some wiki formatting

BrettMayson at 02:31, 2 January 2026

BrettMayson at 00:29, 2 January 2026

Lou Montana: Fix SQF

Lou Montana: Text replacement - "`([^\[]+)<\/code>" to "$1"`

Lou Montana: Text replacement - "\|x([0-9])= `([^<])<\/code>" to "|x$1= $2"`

Lou Montana: Text replacement - "`([^<])\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]) *<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^<])\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]) *<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^<])\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]) *<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^<])\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]) *<\/code>" to "$1$2$3"`

← Older revision		Revision as of 21:08, 13 May 2022
Line 42:		Line 42:

	\|x3= The correct usage of shorthand alt syntax:		\|x3= The correct usage of shorthand alt syntax:
	<~~code~~>try {		<sqf>try {
	if (a > b) throw "Error: some error"; // OK		if (a > b) throw "Error: some error"; // OK
	// The command argument is static		// The command argument is static
Line 69:		Line 69:
	} catch {		} catch {
	hint str _exception;		hint str _exception;
	};</~~code~~>		};</sqf>

	\|seealso= [[Exception handling]] [[try]] [[catch]]		\|seealso= [[Exception handling]] [[try]] [[catch]]
	}}		}}

← Older revision		Revision as of 11:25, 13 May 2022
Line 37:		Line 37:
	\|r2= [[Nothing]]		\|r2= [[Nothing]]

	\|x1= <~~code~~>try {throw "invalid argument"} catch {hint str _exception};</~~code~~>		\|x1= <sqf>try {throw "invalid argument"} catch {hint str _exception};</sqf>

	\|x2= <~~code~~>123 try {if (_this != 123) throw "invalid argument"} catch {hint str _exception};</~~code~~>		\|x2= <sqf>123 try {if (_this != 123) throw "invalid argument"} catch {hint str _exception};</sqf>

	\|x3= The correct usage of shorthand alt syntax:		\|x3= The correct usage of shorthand alt syntax:

← Older revision		Revision as of 14:10, 12 May 2022
Line 68:		Line 68:
	// _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>		};</code>

	\|seealso= [[Exception handling]] [[try]] [[catch]]		\|seealso= [[Exception handling]] [[try]] [[catch]]
	}}		}}

← Older revision		Revision as of 14:10, 12 May 2022
Line 67:		Line 67:
	// The command argument is dynamic		// The command argument is dynamic
	// _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>		};</code>

← Older revision		Revision as of 14:10, 12 May 2022
Line 66:		Line 66:
	if (a > b) then {throw (call _someFunc)}; /// OK		if (a > b) then {throw (call _someFunc)}; /// OK
	// The command argument is dynamic		// The command argument is dynamic
	// _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;

throw - Revision history

Lou Montana: Some wiki formatting

BrettMayson at 02:31, 2 January 2026

BrettMayson at 00:29, 2 January 2026

Lou Montana: Fix SQF

Lou Montana: Text replacement - "([^\[]+)<\/code>" to "$1"

Lou Montana: Text replacement - "\|x([0-9])= *([^<]*)<\/code>" to "|x$1= $2"

Lou Montana: Text replacement - "([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "$1$2$3"

Lou Montana: Text replacement - "([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "$1$2$3"

Lou Montana: Text replacement - "([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "$1$2$3"

Lou Montana: Text replacement - "([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "$1$2$3"

Lou Montana: Text replacement - "`([^\[]+)<\/code>" to "$1"`

Lou Montana: Text replacement - "\|x([0-9])= `([^<])<\/code>" to "|x$1= $2"`

Lou Montana: Text replacement - "`([^<])\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]) *<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^<])\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]) *<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^<])\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]) *<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^<])\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]) *<\/code>" to "$1$2$3"`