Control Structures - Revision history

Lou Montana: Fix

2024-04-25T21:29:06Z

Fix

← Older revision		Revision as of 23:29, 25 April 2024
Line 398:		Line 398:

	'''Example:'''		'''Example:'''
	<sqf>if (myCondition) then { myValueA; } else { myValueB; }; // returns myValueA or myValueB		<sqf>if (myCondition) then { myValueA; } else { myValueB; }; // returns myValueA or myValueB</sqf>


Line 406:		Line 406:
	* [[Statement]]		* [[Statement]]
	* [[Expression]]		* [[Expression]]


	[[Category: Syntax]]		[[Category: Syntax]]

Lou Montana: Some wiki formatting

2024-04-04T00:46:26Z

Some wiki formatting

← Older revision		Revision as of 02:46, 4 April 2024
Line 229:		Line 229:
	=== {{hl\|[[while]]}}-Loop ===		=== {{hl\|[[while]]}}-Loop ===

	This loop repeats the same code block as long as a given [[~~boolean~~]] condition is {{hl\|true}}.		This loop repeats the same code block as long as a given [[Boolean]] condition is {{hl\|true}}.

	[[while]] {CONDITION} [[do]] {{cc\|Note the curly braces}}		[[while]] {CONDITION} [[do]] {{cc\|Note the curly braces}}

Lou Montana: Text replacement - "[[ArmA: Introduction to Scripting" to "[[Introduction to Arma Scripting"

2023-05-30T10:29:54Z

Text replacement - "[[ArmA: Introduction to Scripting" to "[[Introduction to Arma Scripting"

← Older revision		Revision as of 12:29, 30 May 2023
Line 9:		Line 9:
	To fully understand this article you should read the following articles:		To fully understand this article you should read the following articles:

	* [[~~ArmA:~~ Introduction to Scripting]]		* [[Introduction to Arma Scripting]]
	* [[Variables]]		* [[Variables]]
	* [[Operators]]		* [[Operators]]

Lou Montana: Some wiki formatting

2022-07-29T13:25:56Z

Some wiki formatting

Show changes

Lou Montana: Text replacement - "`([^= ]+)<\/tt>" to "{{hl|$1}}"`

2021-11-15T23:17:49Z Text replacement - "<tt>([^= ]+)<\/tt>" to "{{hl|$1}}" ← Older revision Revision as of 01:17, 16 November 2021 Line 18: Line 18: '''Conditional structures''' help to define code which is only executed under certain circumstances. Often you will write code that depends on the game state, on other code or other conditions. '''Conditional structures''' help to define code which is only executed under certain circumstances. Often you will write code that depends on the game state, on other code or other conditions. === <tt>[[if]]</tt>-Statement === === {{hl|[[if]]}}-Statement === The {{hl|if}}-statement defines code that is only executed '''if''' a certain condition is met. The syntax of it looks like that: The {{hl|if}}-statement defines code that is only executed '''if''' a certain condition is met. The syntax of it looks like that: Line 41: Line 41: * If the value is 0 or greater than 0, the nested code is ignored. * If the value is 0 or greater than 0, the nested code is ignored. * If the value is less than 0, the command <tt>hint "Snow!";</tt> is executed. * If the value is less than 0, the command {{hl|hint "Snow!";}} is executed. ==== Alternative Code ([[else]]) ==== ==== Alternative Code ([[else]]) ==== Line 109: Line 109: ... ... ==== Nested <tt>[[if]]</tt>-Statements ==== ==== Nested {{hl|[[if]]}}-Statements ==== Since the {{hl|if}}-statement is itself a [[Statement|statement]], you can also create '''nested {{hl|if}}-statements'''. Since the {{hl|if}}-statement is itself a [[Statement|statement]], you can also create '''nested {{hl|if}}-statements'''. Line 130: Line 130: }; }; {{ArgTitle|3|<tt>[[switch]]</tt>-Statement|{{GVI|arma1|1.00}}}} {{ArgTitle|3|{{hl|[[switch]]}}-Statement|{{GVI|arma1|1.00}}}} In some cases you may want to check a [[Variables|variable]] for several values and execute different code depending on the value. In some cases you may want to check a [[Variables|variable]] for several values and execute different code depending on the value. Line 182: Line 182: }; }; ==== <tt>[[default]]</tt>-Block ==== ==== {{hl|[[default]]}}-Block ==== In some cases you may want to define alternative code that is executed, when none of the values matches. You can write this code in a {{hl|default}}-Block. In some cases you may want to define alternative code that is executed, when none of the values matches. You can write this code in a {{hl|default}}-Block. Line 214: Line 214: '''Loops''' are used to execute the same [[Block|code block]] for a specific or unspecific number of times. '''Loops''' are used to execute the same [[Block|code block]] for a specific or unspecific number of times. === <tt>[[while]]</tt>-Loop === === {{hl|[[while]]}}-Loop === This loop repeats the same code block as long as a given [[boolean]] condition is {{hl|true}}. This loop repeats the same code block as long as a given [[boolean]] condition is {{hl|true}}. Line 242: Line 242: }; }; {{ArgTitle|3|<tt>[[for]]</tt>-Loop|{{GVI|arma1|1.00}}}} {{ArgTitle|3|{{hl|[[for]]}}-Loop|{{GVI|arma1|1.00}}}} The {{hl|for}}-loop repeats the same code block for a specific number of times. The {{hl|for}}-loop repeats the same code block for a specific number of times. Line 288: Line 288: # The variable {{hl|_i}} is set to 0 # The variable {{hl|_i}} is set to 0 # The condition <tt>_i<10</tt> is evaluated, which is {{hl|true}} until {{hl|_i}} surpasses 9. # The condition {{hl|_i<10}} is evaluated, which is {{hl|true}} until {{hl|_i}} surpasses 9. # The code <tt>player globalChat _i;</tt> is executed # The code {{hl|player globalChat _i;}} is executed # The variable {{hl|_i}} is incremented by 1, back to step 2. # The variable {{hl|_i}} is incremented by 1, back to step 2. ==== <tt>[[for]]</tt>-<tt>[[from]]</tt>-<tt>[[to]]</tt>-Loop ==== ==== {{hl|[[for]]}}-{{hl|[[from]]}}-{{hl|[[to]]}}-Loop ==== There exists an alternate syntax of the {{hl|for}}-loop, which simplifies the last example a bit. There exists an alternate syntax of the {{hl|for}}-loop, which simplifies the last example a bit. Line 329: Line 329: #Back to step 2 #Back to step 2 ==== <tt>[[for]]</tt>-<tt>[[from]]</tt>-<tt>[[to]]</tt>-Loop with custom <tt>[[step]]</tt> ==== ==== {{hl|[[for]]}}-{{hl|[[from]]}}-{{hl|[[to]]}}-Loop with custom {{hl|[[step]]}} ==== The default step to increment the variable in {{hl|for}}-{{hl|from}}-{{hl|to}}-Loops is 1. You can set a custom step though using this syntax: The default step to increment the variable in {{hl|for}}-{{hl|from}}-{{hl|to}}-Loops is 1. You can set a custom step though using this syntax: Line 357: Line 357: #Back to step 2 #Back to step 2 === <tt>[[forEach]]</tt>-Loop === === {{hl|[[forEach]]}}-Loop === You will often use the {{hl|forEach}}-loop to increment over [[Array|arrays]]. You will often use the {{hl|forEach}}-loop to increment over [[Array|arrays]]. Line 367: Line 367: } [[forEach]] ARRAY; } [[forEach]] ARRAY; The code block is executed exactly <tt>([[count]] ARRAY)</tt> times. The code block is executed exactly {{hl|([[count]] ARRAY)}} times. You may use the [[Magic Variables|magic variable]] {{hl|_x}} within the code block, which always references to the current item of the array. You may use the [[Magic Variables|magic variable]] {{hl|_x}} within the code block, which always references to the current item of the array. Line 383: Line 383: '''Description:''' '''Description:''' # In the first loop, the statement <tt>unit1 setDamage 1;</tt> is executed # In the first loop, the statement {{hl|unit1 setDamage 1;}} is executed # In the second loop, the statement <tt>unit2 setDamage 1;</tt> is executed # In the second loop, the statement {{hl|unit2 setDamage 1;}} is executed # In the third loop, the statement <tt>unit3 setDamage 1;</tt> is executed # In the third loop, the statement {{hl|unit3 setDamage 1;}} is executed {{Feature|warning|Each iteration will be executed within one frame, even if it consists of multiple instructions. So be aware of large and/or complex code blocks!}} {{Feature|warning|Each iteration will be executed within one frame, even if it consists of multiple instructions. So be aware of large and/or complex code blocks!}}

Lou Montana: Text replacement - "([a-zA-Z0-9\. _"\\']+)<\/tt>" to "{{hl|$1}}" 2021-11-15T22:55:47Z Text replacement - "<tt>([a-zA-Z0-9\. _"\\']+)<\/tt>" to "{{hl|$1}}" Show changes Lou Montana: Text replacement - "\{\{ArgTitle *\| *([^\|]+) *\| *([1-6]) *\|" to "{{ArgTitle|$2|$1|" 2021-08-08T23:43:51Z Text replacement - "\{\{ArgTitle *\| *([^\|]+) *\| *([1-6]) *\|" to "{{ArgTitle|$2|$1|" ← Older revision Revision as of 01:43, 9 August 2021 Line 130: Line 130: }; }; {{ArgTitle|<tt>[[switch]]</tt>-Statement|3|{{GVI|arma1|1.00}}}} {{ArgTitle|3|<tt>[[switch]]</tt>-Statement|{{GVI|arma1|1.00}}}} In some cases you may want to check a [[Variables|variable]] for several values and execute different code depending on the value. In some cases you may want to check a [[Variables|variable]] for several values and execute different code depending on the value. Line 242: Line 242: }; }; {{ArgTitle|<tt>[[for]]</tt>-Loop|3|{{GVI|arma1|1.00}}}} {{ArgTitle|3|<tt>[[for]]</tt>-Loop|{{GVI|arma1|1.00}}}} The <tt>for</tt>-loop repeats the same code block for a specific number of times. The <tt>for</tt>-loop repeats the same code block for a specific number of times. Ansin11: Added "Command Group: Program Flow" to See Also 2021-07-07T12:20:15Z Added "Command Group: Program Flow" to See Also ← Older revision Revision as of 14:20, 7 July 2021 Line 398: Line 398: [[if]] (myCondition) [[then]] { myValueA; } else { myValueB; }; {{cc|Returns myValueA or myValueB}} [[if]] (myCondition) [[then]] { myValueA; } else { myValueB; }; {{cc|Returns myValueA or myValueB}} == See also == == See Also == * [[:Category:Command Group: Program Flow|Command Group: Program Flow]] * [[Statement]] * [[Statement]] * [[Expression]] * [[Expression]] [[Category: Syntax]] [[Category: Syntax]] Zarickan: Corrected description of else command, it returns a 1-dimensional of [left, right] 2021-06-02T19:43:06Z Corrected description of else command, it returns a 1-dimensional of [left, right] ← Older revision Revision as of 21:43, 2 June 2021 Line 61: Line 61: [[if]] (CONDITION) [[then]] [{STATEMENT1; ...}, {STATEMENT2; ...}]; [[if]] (CONDITION) [[then]] [{STATEMENT1; ...}, {STATEMENT2; ...}]; In fact the above syntax with the Array is the only possible syntax as [[else]] does nothing else than taking the code to it is left and the one to it is right and packs them both into a 2-dimensional [[Array]] of [[Code]] which is then fed into the [[then]] operator. But using [[else]] is just as fine and in most cases better in case of readability of your code.<br> In fact the above syntax with the Array is the only possible syntax as [[else]] does nothing else than taking the code to its left and the one to its right and packs them both into an [[Array]] of [[Code]] which is then fed into the [[then]] operator. But using [[else]] is just as fine and in most cases better in case of readability of your code.<br> Here you have a second sequence of [[Statement|statements]] executed when <tt>CONDITION</tt> is <tt>false</tt>. Here you have a second sequence of [[Statement|statements]] executed when <tt>CONDITION</tt> is <tt>false</tt>. Lou Montana: spaces → tab 2021-04-24T20:31:15Z spaces → tab Show changes

Control Structures - Revision history

Lou Montana: Fix

Lou Montana: Some wiki formatting

Lou Montana: Text replacement - "[[ArmA: Introduction to Scripting" to "[[Introduction to Arma Scripting"

Lou Montana: Some wiki formatting

Lou Montana: Text replacement - "`([^= ]+)<\/tt>" to "{{hl|$1}}"`

Lou Montana: Text replacement - "`([a-zA-Z0-9\. _"\\']+)<\/tt>" to "{{hl|$1}}"`

Lou Montana: Text replacement - "\{\{ArgTitle \| ([^\|]+) \| ([1-6]) *\|" to "{{ArgTitle|$2|$1|"

Ansin11: Added "Command Group: Program Flow" to See Also

Zarickan: Corrected description of else command, it returns a 1-dimensional of [left, right]

Lou Montana: spaces → tab

← Older revision		Revision as of 01:17, 16 November 2021
Line 18:		Line 18:
	'''Conditional structures''' help to define code which is only executed under certain circumstances. Often you will write code that depends on the game state, on other code or other conditions.		'''Conditional structures''' help to define code which is only executed under certain circumstances. Often you will write code that depends on the game state, on other code or other conditions.

	=== ~~<tt>~~[[if]]~~</tt>~~-Statement ===		=== {{hl\|[[if]]}}-Statement ===

	The {{hl\|if}}-statement defines code that is only executed '''if''' a certain condition is met. The syntax of it looks like that:		The {{hl\|if}}-statement defines code that is only executed '''if''' a certain condition is met. The syntax of it looks like that:
Line 41:		Line 41:

	* If the value is 0 or greater than 0, the nested code is ignored.		* If the value is 0 or greater than 0, the nested code is ignored.
	* If the value is less than 0, the command ~~<tt>~~hint "Snow!";~~</tt>~~ is executed.		* If the value is less than 0, the command {{hl\|hint "Snow!";}} is executed.

	==== Alternative Code ([[else]]) ====		==== Alternative Code ([[else]]) ====
Line 109:		Line 109:
	...		...

	==== Nested ~~<tt>~~[[if]]~~</tt>~~-Statements ====		==== Nested {{hl\|[[if]]}}-Statements ====
	Since the {{hl\|if}}-statement is itself a [[Statement\|statement]], you can also create '''nested {{hl\|if}}-statements'''.		Since the {{hl\|if}}-statement is itself a [[Statement\|statement]], you can also create '''nested {{hl\|if}}-statements'''.

Line 130:		Line 130:
	};		};

	{{ArgTitle\|3\|~~<tt>~~[[switch]]~~</tt>~~-Statement\|{{GVI\|arma1\|1.00}}}}		{{ArgTitle\|3\|{{hl\|[[switch]]}}-Statement\|{{GVI\|arma1\|1.00}}}}

	In some cases you may want to check a [[Variables\|variable]] for several values and execute different code depending on the value.		In some cases you may want to check a [[Variables\|variable]] for several values and execute different code depending on the value.
Line 182:		Line 182:
	};		};

	==== ~~<tt>~~[[default]]~~</tt>~~-Block ====		==== {{hl\|[[default]]}}-Block ====
	In some cases you may want to define alternative code that is executed, when none of the values matches. You can write this code in a {{hl\|default}}-Block.		In some cases you may want to define alternative code that is executed, when none of the values matches. You can write this code in a {{hl\|default}}-Block.

Line 214:		Line 214:
	'''Loops''' are used to execute the same [[Block\|code block]] for a specific or unspecific number of times.		'''Loops''' are used to execute the same [[Block\|code block]] for a specific or unspecific number of times.

	=== ~~<tt>~~[[while]]~~</tt>~~-Loop ===		=== {{hl\|[[while]]}}-Loop ===

	This loop repeats the same code block as long as a given [[boolean]] condition is {{hl\|true}}.		This loop repeats the same code block as long as a given [[boolean]] condition is {{hl\|true}}.
Line 242:		Line 242:
	};		};

	{{ArgTitle\|3\|~~<tt>~~[[for]]~~</tt>~~-Loop\|{{GVI\|arma1\|1.00}}}}		{{ArgTitle\|3\|{{hl\|[[for]]}}-Loop\|{{GVI\|arma1\|1.00}}}}

	The {{hl\|for}}-loop repeats the same code block for a specific number of times.		The {{hl\|for}}-loop repeats the same code block for a specific number of times.
Line 288:		Line 288:

	# The variable {{hl\|_i}} is set to 0		# The variable {{hl\|_i}} is set to 0
	# The condition ~~<tt>~~_i<10~~</tt>~~ is evaluated, which is {{hl\|true}} until {{hl\|_i}} surpasses 9.		# The condition {{hl\|_i<10}} is evaluated, which is {{hl\|true}} until {{hl\|_i}} surpasses 9.
	# The code ~~<tt>~~player globalChat _i;~~</tt>~~ is executed		# The code {{hl\|player globalChat _i;}} is executed
	# The variable {{hl\|_i}} is incremented by 1, back to step 2.		# The variable {{hl\|_i}} is incremented by 1, back to step 2.

	==== ~~<tt>~~[[for]]~~</tt>~~-~~<tt>~~[[from]]~~</tt>~~-~~<tt>~~[[to]]~~</tt>~~-Loop ====		==== {{hl\|[[for]]}}-{{hl\|[[from]]}}-{{hl\|[[to]]}}-Loop ====
	There exists an alternate syntax of the {{hl\|for}}-loop, which simplifies the last example a bit.		There exists an alternate syntax of the {{hl\|for}}-loop, which simplifies the last example a bit.

Line 329:		Line 329:
	#Back to step 2		#Back to step 2

	==== ~~<tt>~~[[for]]~~</tt>~~-~~<tt>~~[[from]]~~</tt>~~-~~<tt>~~[[to]]~~</tt>~~-Loop with custom ~~<tt>~~[[step]]~~</tt>~~ ====		==== {{hl\|[[for]]}}-{{hl\|[[from]]}}-{{hl\|[[to]]}}-Loop with custom {{hl\|[[step]]}} ====
	The default step to increment the variable in {{hl\|for}}-{{hl\|from}}-{{hl\|to}}-Loops is 1. You can set a custom step though using this syntax:		The default step to increment the variable in {{hl\|for}}-{{hl\|from}}-{{hl\|to}}-Loops is 1. You can set a custom step though using this syntax:

Line 357:		Line 357:
	#Back to step 2		#Back to step 2

	=== ~~<tt>~~[[forEach]]~~</tt>~~-Loop ===		=== {{hl\|[[forEach]]}}-Loop ===

	You will often use the {{hl\|forEach}}-loop to increment over [[Array\|arrays]].		You will often use the {{hl\|forEach}}-loop to increment over [[Array\|arrays]].
Line 367:		Line 367:
	} [[forEach]] ARRAY;		} [[forEach]] ARRAY;

	The code block is executed exactly ~~<tt>~~([[count]] ARRAY)~~</tt>~~ times.		The code block is executed exactly {{hl\|([[count]] ARRAY)}} times.

	You may use the [[Magic Variables\|magic variable]] {{hl\|_x}} within the code block, which always references to the current item of the array.		You may use the [[Magic Variables\|magic variable]] {{hl\|_x}} within the code block, which always references to the current item of the array.
Line 383:		Line 383:
	'''Description:'''		'''Description:'''

	# In the first loop, the statement ~~<tt>~~unit1 setDamage 1;~~</tt>~~ is executed		# In the first loop, the statement {{hl\|unit1 setDamage 1;}} is executed
	# In the second loop, the statement ~~<tt>~~unit2 setDamage 1;~~</tt>~~ is executed		# In the second loop, the statement {{hl\|unit2 setDamage 1;}} is executed
	# In the third loop, the statement ~~<tt>~~unit3 setDamage 1;~~</tt>~~ is executed		# In the third loop, the statement {{hl\|unit3 setDamage 1;}} is executed

	{{Feature\|warning\|Each iteration will be executed within one frame, even if it consists of multiple instructions. So be aware of large and/or complex code blocks!}}		{{Feature\|warning\|Each iteration will be executed within one frame, even if it consists of multiple instructions. So be aware of large and/or complex code blocks!}}

← Older revision		Revision as of 01:43, 9 August 2021
Line 130:		Line 130:
	};		};

	{{ArgTitle\|<tt>[[switch]]</tt>-Statement\|3\|{{GVI\|arma1\|1.00}}}}		{{ArgTitle\|3\|<tt>[[switch]]</tt>-Statement\|{{GVI\|arma1\|1.00}}}}

	In some cases you may want to check a [[Variables\|variable]] for several values and execute different code depending on the value.		In some cases you may want to check a [[Variables\|variable]] for several values and execute different code depending on the value.
Line 242:		Line 242:
	};		};

	{{ArgTitle\|<tt>[[for]]</tt>-Loop\|3\|{{GVI\|arma1\|1.00}}}}		{{ArgTitle\|3\|<tt>[[for]]</tt>-Loop\|{{GVI\|arma1\|1.00}}}}

	The <tt>for</tt>-loop repeats the same code block for a specific number of times.		The <tt>for</tt>-loop repeats the same code block for a specific number of times.

← Older revision		Revision as of 14:20, 7 July 2021
Line 398:		Line 398:
	[[if]] (myCondition) [[then]] { myValueA; } else { myValueB; }; {{cc\|Returns myValueA or myValueB}}		[[if]] (myCondition) [[then]] { myValueA; } else { myValueB; }; {{cc\|Returns myValueA or myValueB}}

	== See ~~also~~ ==		== See Also ==
			* [[:Category:Command Group: Program Flow\|Command Group: Program Flow]]
	* [[Statement]]		* [[Statement]]
	* [[Expression]]		* [[Expression]]

	[[Category: Syntax]]		[[Category: Syntax]]

← Older revision		Revision as of 21:43, 2 June 2021
Line 61:		Line 61:
	[[if]] (CONDITION) [[then]] [{STATEMENT1; ...}, {STATEMENT2; ...}];		[[if]] (CONDITION) [[then]] [{STATEMENT1; ...}, {STATEMENT2; ...}];

	In fact the above syntax with the Array is the only possible syntax as [[else]] does nothing else than taking the code to ~~it is~~ left and the one to ~~it is~~ right and packs them both into ~~a 2-dimensional~~ [[Array]] of [[Code]] which is then fed into the [[then]] operator. But using [[else]] is just as fine and in most cases better in case of readability of your code.<br>		In fact the above syntax with the Array is the only possible syntax as [[else]] does nothing else than taking the code to its left and the one to its right and packs them both into an [[Array]] of [[Code]] which is then fed into the [[then]] operator. But using [[else]] is just as fine and in most cases better in case of readability of your code.<br>
	Here you have a second sequence of [[Statement\|statements]] executed when <tt>CONDITION</tt> is <tt>false</tt>.		Here you have a second sequence of [[Statement\|statements]] executed when <tt>CONDITION</tt> is <tt>false</tt>.

Control Structures - Revision history

Lou Montana: Fix

Lou Montana: Some wiki formatting

Lou Montana: Text replacement - "[[ArmA: Introduction to Scripting" to "[[Introduction to Arma Scripting"

Lou Montana: Some wiki formatting

Lou Montana: Text replacement - "([^= ]+)<\/tt>" to "{{hl|$1}}"

Lou Montana: Text replacement - "([a-zA-Z0-9\. _"\\']+)<\/tt>" to "{{hl|$1}}"

Lou Montana: Text replacement - "\{\{ArgTitle *\| *([^\|]+) *\| *([1-6]) *\|" to "{{ArgTitle|$2|$1|"

Ansin11: Added "Command Group: Program Flow" to See Also

Zarickan: Corrected description of else command, it returns a 1-dimensional of [left, right]

Lou Montana: spaces → tab

Lou Montana: Text replacement - "`([^= ]+)<\/tt>" to "{{hl|$1}}"`

Lou Montana: Text replacement - "`([a-zA-Z0-9\. _"\\']+)<\/tt>" to "{{hl|$1}}"`

Lou Montana: Text replacement - "\{\{ArgTitle \| ([^\|]+) \| ([1-6]) *\|" to "{{ArgTitle|$2|$1|"