while - Revision history

Lou Montana: Text replacement - "[] spawn" to "0 spawn"

2024-09-02T20:24:55Z

Text replacement - "[] spawn" to "0 spawn"

← Older revision		Revision as of 22:24, 2 September 2024
Line 51:		Line 51:

	\|x3= <sqf>		\|x3= <sqf>
	[] spawn {		0 spawn {
	// warning: while loop without suspension executes multiple times per frame		// warning: while loop without suspension executes multiple times per frame
	private _counter = 0;		private _counter = 0;

Lou Montana: Text replacement - "{{Feature | Important | " to "{{Feature|important|"

2024-05-16T20:46:46Z

Text replacement - "{{Feature | Important | " to "{{Feature|important|"

← Older revision		Revision as of 22:46, 16 May 2024
Line 25:		Line 25:

	\|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.		\|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.
	{{Feature \| ~~Important~~ \|		{{Feature\|important\|
	* A [[while]] loop does not have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment\|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended (see {{Link\|#Example 3}}).		* A [[while]] loop does not have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment\|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended (see {{Link\|#Example 3}}).
	* 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\|non-scheduled environment]], [[while]] [[do]] loop is limited to 10,000 iterations, after which it exits even if condition is still [[true]].

POLPOX: Moved KK's note about unscheduled 10000 iteration limitation into description

2023-11-07T06:52:36Z

Moved KK's note about unscheduled 10000 iteration limitation into description

← Older revision		Revision as of 08:52, 7 November 2023
Line 25:		Line 25:

	\|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.		\|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.
	{{Feature \| Important \| A [[while]] loop does not have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment\|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended (see {{Link\|#Example 3}}).}}		{{Feature \| Important \|
			* A [[while]] loop does not have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment\|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended (see {{Link\|#Example 3}}).
			* 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]].
			}}
	\|s1= [[while]] condition		\|s1= [[while]] condition

Line 82:		Line 85:
	\|text= The boolean code that is used to evaluate the while condition can be preceded by code that executes a regular command.		\|text= The boolean code that is used to evaluate the while condition can be preceded by code that executes a regular command.
	<sqf>while { _a =_a + 1; _a < 10 } do { /* ... */ };</sqf>		<sqf>while { _a =_a + 1; _a < 10 } do { /* ... */ };</sqf>
	}}

	~~{{Note~~
	~~\|user= Killzone Kid~~
	~~\|timestamp= 20140830081200~~
	\|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.
	}}		}}

Lou Montana: Text replacement - "{{HashLink" to "{{Link"

2023-01-04T16:44:17Z

Text replacement - "{{HashLink" to "{{Link"

← Older revision		Revision as of 18:44, 4 January 2023
Line 25:		Line 25:

	\|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.		\|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.
	{{Feature \| Important \| A [[while]] loop does not have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment\|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended (see {{~~HashLink~~\|#Example 3}}).}}		{{Feature \| Important \| A [[while]] loop does not have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment\|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended (see {{Link\|#Example 3}}).}}
	\|s1= [[while]] condition		\|s1= [[while]] condition

Lou Montana: Some wiki formatting

2022-05-12T09:49:22Z

Some wiki formatting

← Older revision		Revision as of 11:49, 12 May 2022
Line 81:		Line 81:
	\|timestamp= 20080514084000		\|timestamp= 20080514084000
	\|text= The boolean code that is used to evaluate the while condition can be preceded by code that executes a regular command.		\|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~~>		<sqf>while { _a =_a + 1; _a < 10 } do { /* ... */ };</sqf>
	}}		}}

Lou Montana: Fix

2022-03-24T17:45:57Z

Fix

← Older revision		Revision as of 19:45, 24 March 2022
Line 69:		Line 69:
	uiSleep 0.001; // waits at least 1 frame		uiSleep 0.001; // waits at least 1 frame
	};		};
	// _counter ~~prints~~ one per frame, as expected		// _counter says one per frame, as expected
	hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];		hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];
	};		};

Lou Montana: Some wiki formatting

2022-03-24T17:45:13Z

Some wiki formatting

← Older revision		Revision as of 19:45, 24 March 2022
Line 25:		Line 25:

	\|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.		\|descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.
	{{Feature \| Important \| A while loop ~~doesn't~~ have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment\|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended~~. See~~ Example 3.}}		{{Feature \| Important \| A [[while]] loop does not have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment\|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended (see {{HashLink\|#Example 3}}).}}
	\|s1= [[while]] condition		\|s1= [[while]] condition

Line 32:		Line 32:
	\|r1= [[While Type]]		\|r1= [[While Type]]

	\|x1= <~~code~~>[[while]] {a < b} [[do]] {a = a + 1};</~~code~~>		\|x1= <sqf>while { a < b } do { a = a + 1 };</sqf>

	\|x2= A practical example: Repair all members of a group to such a level that they are able to stand up:		\|x2= A practical example: Repair all members of a group to such a level that they are able to stand up:
	<~~code~~>{		<sqf>
	[[if]] ([[alive~~]] [[Magic Variables#x\|~~_x]]) [[then]]		{
			if (alive _x) then
	{		{
	[[while]] { [[not~~]] [[~~canStand~~]] [[Magic Variables#x\|~~_x]] } [[do]]		while { not canStand _x } do
	{		{
	~~[[Magic Variables\|~~_x~~]] [[~~setDamage]] ([[damage~~]] [[Magic Variables\|~~_x]] - 0.01);		_x setDamage (damage _x - 0.01);
	};		};
	};		};
	} [[forEach~~]] [[~~units~~]] [[~~group]] unitname;</~~code~~>		} forEach units group unitname;
	\|x3=<sqf>[] spawn {		</sqf>
	//warning! while loop without suspension executes multiple times per frame~~!!!~~
			\|x3= <sqf>
			[] spawn {
			// warning: while loop without suspension executes multiple times per frame
	private _counter = 0;		private _counter = 0;
	private _endTime = diag_tickTime + 5;		private _endTime = diag_tickTime + 5;
	private _frameNo = diag_frameNo;		private _frameNo = diag_frameNo;
	while {diag_tickTime < _endTime} do {		while { diag_tickTime < _endTime } do
			{
	_counter = _counter + 1;		_counter = _counter + 1;
	};		};
	//in an empty mission ~~on a certain test system~~, ~~this prints +~~2000 ~~timer~~ per frame!!!		// in an empty mission, the _counter may go well over 2000 times per frame!
	hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];		hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];
	//with suspension
			// with suspension
	private _counter = 0;		private _counter = 0;
	private _endTime = diag_tickTime + 5;		private _endTime = diag_tickTime + 5;
	private _frameNo = diag_frameNo;		private _frameNo = diag_frameNo;
	while {diag_tickTime < _endTime} do {		while { diag_tickTime < _endTime } do
			{
	_counter = _counter + 1;		_counter = _counter + 1;
	uiSleep 0.001; //waits at least 1 frame		uiSleep 0.001; // waits at least 1 frame
	};		};
	//~~but this~~ prints ~~1 time~~ per frame, as expected		// _counter prints one per frame, as expected
	hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];		hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];
	}		};
	</sqf>		</sqf>

	\|seealso= [[Control Structures]] [[waitUntil]] [[for]] [[do]]		\|seealso= [[Control Structures]] [[waitUntil]] [[for]] [[do]]
	}}		}}

Leopard20 at 17:29, 24 March 2022

2022-03-24T17:29:04Z

← Older revision		Revision as of 19:29, 24 March 2022
Line 52:		Line 52:
	_counter = _counter + 1;		_counter = _counter + 1;
	};		};
			//in an empty mission on a certain test system, this prints +2000 timer per frame!!!
	hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];		hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];
	//with suspension		//with suspension
Line 61:		Line 62:
	uiSleep 0.001; //waits at least 1 frame		uiSleep 0.001; //waits at least 1 frame
	};		};
			//but this prints 1 time per frame, as expected
	hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];		hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];
	}		}

Leopard20 at 17:25, 24 March 2022

2022-03-24T17:25:52Z

← Older revision		Revision as of 19:25, 24 March 2022
Line 44:		Line 44:
	};		};
	} [[forEach]] [[units]] [[group]] unitname;</code>		} [[forEach]] [[units]] [[group]] unitname;</code>
	\|x3=<sqf>		\|x3=<sqf>[] spawn {
	//warning! while loop without suspension executes multiple times per frame!!!		//warning! while loop without suspension executes multiple times per frame!!!
	private _counter = 0;		private _counter = 0;
	private _endTime = diag_tickTime + 5;		private _endTime = diag_tickTime + 5;
	private _frameNo = diag_frameNo;		private _frameNo = diag_frameNo;
	while {diag_tickTime < _endTime} do {		while {diag_tickTime < _endTime} do {
	_counter = _counter + 1;		_counter = _counter + 1;
	};		};
	hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];		hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];
	//with suspension		//with suspension
	private _counter = 0;		private _counter = 0;
	private _endTime = diag_tickTime + 5;		private _endTime = diag_tickTime + 5;
	private _frameNo = diag_frameNo;		private _frameNo = diag_frameNo;
	while {diag_tickTime < _endTime} do {		while {diag_tickTime < _endTime} do {
	_counter = _counter + 1;		_counter = _counter + 1;
	uiSleep 0.001; //waits at least 1 frame		uiSleep 0.001; //waits at least 1 frame
	};		};
	hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];		hint format ["Average Execution: %1 times per frame", _counter / (diag_frameNo - _frameNo)];
			}
	</sqf>		</sqf>
	\|seealso= [[Control Structures]] [[waitUntil]] [[for]] [[do]]		\|seealso= [[Control Structures]] [[waitUntil]] [[for]] [[do]]

Leopard20: add note about while having no suspension

2022-03-24T17:23:59Z

add note about while having no suspension

@@ Line 25: / Line 25: @@
 |descr= Repeats [[Code]] while the given condition is [[true]]. A part of [[while]]-[[do]] construct.
+{{Feature | Important | A while loop doesn't have any suspension, meaning that if used in [[Scheduler#Scheduled_Environment|scheduled environment]] without any suspension ([[sleep]] or [[uiSleep]]) the code will run multiple times per frame and consumes the 3 ms per frame scheduler execution limit. This should be avoided if not intended. See Example 3.}}
 |s1= [[while]] condition
@@ Line 44: / Line 44: @@
 	};
 } [[forEach]] [[units]] [[group]] unitname;</code>
+|x3=<sqf>
 |seealso= [[Control Structures]] [[waitUntil]] [[for]] [[do]]
 }}