while: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]2(\|.*)?\]\]" to "{{GameCategory|arma2|Scripting Commands}}")
m (Some wiki formatting)
(22 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| ofpr |Game name=
|game1= ofp
|version1= 1.85


|gr1= Program Flow |GROUP1=
|game2= ofpe
|version2= 1.00


|game3= arma1
|version3= 1.00


|game4= arma2
|version4= 1.00


|1.85|Game version=
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| Repeats [[Code]] while condition is [[true]]. A part of [[while]] [[do]] construct. |Description=
|game6= tkoh
____________________________________________________________________________________________
|version6= 1.00


| '''while''' condition |Syntax=
|game7= arma3
|version7= 0.50


|p1= condition: [[Code]]
|gr1= Program Flow


| [[While Type]] |Return value=
|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.
____________________________________________________________________________________________
 
|x1= <code>[[while]] {a < b} [[do]] {a = a + 1};</code>
|x2= A practical example: Repair all members of a group to such a level that they are able to stand up: <code>{
    [[while]] {![[canStand]] [[Magic Variables|_x]] && [[alive]] [[Magic Variables|_x]]} [[do]] {
        [[Magic Variables|_x]] [[setDamage]] ([[damage]] [[Magic Variables|_x]] - 0.01);
    };
} [[forEach]] [[units]] [[group]] unitname;</code> |Example 2=
____________________________________________________________


| [[Control Structures]], [[waitUntil]], [[for]], [[do]] |See also=
|s1= [[while]] condition
}}


<h3 style="display:none">Notes</h3>
|p1= condition: [[Code]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on May 14, 2008
|r1= [[While Type]]
<dt class="note">[[User:Kronzky|Kronzky]]
<dd class="note">The boolean code that's used to evaluate the while condition can be preceded by code that executes a regular command.<br>
<code>[[while]] {_a =_a + 1; _a < 10} [[do]] {...}</code>
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|x1= <code>[[while]] {a < b} [[do]] {a = a + 1};</code>


|x2= A practical example: Repair all members of a group to such a level that they are able to stand up:
<code>{
[[if]] ([[alive]] [[Magic Variables#x|_x]]) [[then]]
{
[[while]] { [[not]] [[canStand]] [[Magic Variables#x|_x]] } [[do]]
{
[[Magic Variables|_x]] [[setDamage]] ([[damage]] [[Magic Variables|_x]] - 0.01);
};
};
} [[forEach]] [[units]] [[group]] unitname;</code>


[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
|seealso= [[Control Structures]], [[waitUntil]], [[for]], [[do]]
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma3|Scripting Commands}}


{{Note
|user= Kronzky
|timestamp= 20080514084000
|text= The boolean code that is used to evaluate the while condition can be preceded by code that executes a regular command.
<code>[[while]] {_a =_a + 1; _a < 10} [[do]] {...}</code>
}}


 
{{Note
<!-- CONTINUE Notes -->
|user= Killzone Kid
<dl class="command_description">
|timestamp= 20140830081200
<dd class="notedate">Posted on August 30, 2014 - 08:12 (UTC)</dd>
|text= In [[Scheduler#Unscheduled_Environment|non-scheduled environment]], [[while]] [[do]] loop is limited to 10,000 iterations, after which it exits even if condition is still [[true]]. In [[Scheduler#Unscheduled_Environment|scheduled environment]] no such limit exists.
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
}}
<dd class="note">
In [[Scheduler#Unscheduled_Environment|non-scheduled environment]], [[while]] [[do]] loop is limited to 10,000 iterations, after which it exits even if condition is still [[true]]. In [[Scheduler#Unscheduled_Environment|scheduled environment]] no such limit exists.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 22:28, 21 September 2021

Hover & click on the images for description

Description

Description:
Repeats Code while the given condition is true. A part of while-do construct.
Groups:
Program Flow

Syntax

Syntax:
while condition
Parameters:
condition: Code
Return Value:
While Type

Examples

Example 1:
while {a < b} do {a = a + 1};
Example 2:
A practical example: Repair all members of a group to such a level that they are able to stand up: { if (alive _x) then { while { not canStand _x } do { _x setDamage (damage _x - 0.01); }; }; } forEach units group unitname;

Additional Information

See also:
Control StructureswaitUntilfordo

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
Kronzky - c
Posted on May 14, 2008 - 08:40 (UTC)
The boolean code that is used to evaluate the while condition can be preceded by code that executes a regular command. while {_a =_a + 1; _a < 10} do {...}
Killzone Kid - c
Posted on Aug 30, 2014 - 08:12 (UTC)
In non-scheduled environment, while do loop is limited to 10,000 iterations, after which it exits even if condition is still true. In scheduled environment no such limit exists.