count: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) |
Lou Montana (talk | contribs) m (Clarify array text) |
||
(39 intermediate revisions by 2 users not shown) | |||
Line 34: | Line 34: | ||
* The number of elements in an array matching the condition | * The number of elements in an array matching the condition | ||
* The number of sub-entries in a config entry | * The number of sub-entries in a config entry | ||
* {{GVI|arma3|1.28|size=0. | * {{GVI|arma3|1.28|size= 0.75}} The number of characters in an ANSI string {{Feature|informative|If Unicode support is desired, see [[forceUnicode]].}} | ||
|s1= [[count]] value | |s1= [[count]] value | ||
Line 44: | Line 44: | ||
|s2= condition [[count]] array | |s2= condition [[count]] array | ||
|p21= condition: [[Code]] - | |p21= condition: [[Code]] - condition that must return [[true]] for the tested element to be counted. The variable {{hl|[[Magic Variables#x|_x]]}} will contain the currently tested element | ||
{{Feature|arma3|If array contains different data types, use [[isEqualTo]] instead of [[==]] | {{Feature|arma3|If the provided array contains different data types, use [[isEqualTo]] for item comparison instead of [[==]].}} | ||
|p22= array: [[Array]] | |p22= array: [[Array]] | ||
Line 51: | Line 51: | ||
|r2= [[Number]] | |r2= [[Number]] | ||
|x1= < | |x1= <sqf>count [0, 0, 1, 2]; // returns 4 | ||
count units group player; // returns number of units in player group</sqf> | |||
|x2= < | |x2= <sqf>private _cnt = { _x == 4 } count [1, 9, 8, 3, 4, 4, 4, 5, 6]; // returns 3 | ||
_cnt = { | _cnt = { alive _x } count allUnits; // returns the number of alive units</sqf> | ||
|x3= < | |x3= <sqf>private _cnt = count (configFile >> "CfgVehicles");</sqf> | ||
|x4= < | |x4= <sqf>hint str count "japa is the man!"; // 16</sqf> | ||
|x5= < | |x5= <sqf>hint format ["There are %1 elements in the provided hashmap", count _myHashMap];</sqf> | ||
|seealso= [[apply]] [[select]] [[in]] [[find]] [[countFriendly]] [[countEnemy]] [[countUnknown]] [[countSide]] [[countType]] [[findIf]] | |seealso= [[apply]] [[select]] [[in]] [[find]] [[countFriendly]] [[countEnemy]] [[countUnknown]] [[countSide]] [[countType]] [[findIf]] [[forceUnicode]] | ||
}} | }} | ||
{{Note | |||
|user= Hardrock | |||
|timestamp= 20060803142700 | |||
|text= ''Notes from before the conversion:''<br> | |||
Use this to calculate how many "M16" mags a soldier has left. | Use this to calculate how many "M16" mags a soldier has left. | ||
< | <sqf>{ _x == "M16" } count magazines soldier1;</sqf> | ||
Take care when using count to determine how many units are left alive in a group: count units [[group]] [[player]] or count units groupname Will return the number of units the leader of the group thinks are alive. If some units have been killed out of sight of other members of the group then it may take sometime for this to be the actual numbers in the group. To determine exactly how many units are really alive in a group use: | Take care when using count to determine how many units are left alive in a group: count units [[group]] [[player]] or count units groupname Will return the number of units the leader of the group thinks are alive. If some units have been killed out of sight of other members of the group then it may take sometime for this to be the actual numbers in the group. To determine exactly how many units are really alive in a group use: | ||
< | <sqf>{ alive _x } count units group player;</sqf> | ||
or | or | ||
< | <sqf>{ alive _x } count units groupname;</sqf> | ||
}} | |||
{{Note | |||
|user= Heeeere's Johnny! | |||
|timestamp= 20141215000100 | |||
|text= ''count'' can be (ab)used for a very fast and simple check if at least one element in an array fulfills a certain condition: | |||
''count'' can be (ab)used for a very fast and simple check if at least one element in an array fulfills a certain condition: | <sqf>if ({ if (/* _x fulfills condition */) exitWith {1}; false } count _array isEqualTo 1) then | ||
< | |||
{ | { | ||
// do whatever here | |||
};</ | };</sqf> | ||
This code will exit the ''count'' loop as soon as it finds an element fulfilling the condition, leaving the ''count'' with the value of 1, hence make the larger if-condition be ''true''.<br> | This code will exit the ''count'' loop as soon as it finds an element fulfilling the condition, leaving the ''count'' with the value of 1, hence make the larger if-condition be ''true''.<br> | ||
If no array element fulfills the condition, the ''count'' will be 0 and the if-condition will be ''false''. | If no array element fulfills the condition, the ''count'' will be 0 and the if-condition will be ''false''. | ||
}} | |||
{{Note | |||
|user= Killzone_Kid | |||
|timestamp= 20141229212300 | |||
|text= Quit loop at first fulfilled condition (same as above but faster): | |||
Quit loop at first fulfilled condition (same as above but faster): | <sqf>{ | ||
< | if (_x == 4) exitWith { | ||
// do something when we reach 4 | |||
} | |||
} count [1,2,3,4,5,6];</sqf> | |||
}} | |||
{{Note | |||
|user= Heeeere's Johnny! | |||
|timestamp= 20150102223200 | |||
|text= Using [[exitWith]] inside a '''count''' loop will overwrite the default functionality and make '''count''' return whatever the '''exitWith''' returns: | |||
<sqf> | |||
Using [[exitWith]] inside a '''count''' loop will overwrite the default functionality and make '''count''' return whatever the '''exitWith''' returns: | _result = { | ||
< | if (_x isEqualTo 3) exitWith { "Hello" } | ||
} count [1,2,3,4,5]; | |||
} | // _result = "Hello" | ||
</sqf> | |||
}} | |||
{{Note | |||
|user= Ebay | |||
|timestamp= 20160822194100 | |||
|text= With the alternative syntax each iteration should result in an interior return of bool or nothing. Example: | |||
With the alternative syntax each iteration should result in an interior return of bool or nothing. Example: | <sqf> | ||
< | createDialog "RscFunctionsViewer"; | ||
{ | { lbAdd [292901, _x]; } count ["first", "second", "third"]; | ||
</sqf> | |||
[[lbAdd]] returns a number, so this throws "Error Type Number, expected Bool". Tested in A2OA 1.63.131129 | [[lbAdd]] returns a number, so this throws "Error Type Number, expected Bool". Tested in A2OA 1.63.131129 | ||
}} | |||
Revision as of 21:22, 10 July 2024
Description
- Description:
- Can be used to count:
- The number of elements in an array (returns the already internally known array size)
- The number of elements in an array matching the condition
- The number of sub-entries in a config entry
1.28 The number of characters in an ANSI string
- Groups:
- ArraysStringsConfigHashMap
Syntax
Alternative Syntax
- Syntax:
- condition count array
- Parameters:
- condition: Code - condition that must return true for the tested element to be counted. The variable _x will contain the currently tested element
- array: Array
- Return Value:
- Number
Examples
- Example 1:
- Example 2:
- Example 3:
- Example 4:
- Example 5:
Additional Information
- See also:
- apply select in find countFriendly countEnemy countUnknown countSide countType findIf forceUnicode
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
- Posted on Aug 03, 2006 - 14:27 (UTC)
-
Notes from before the conversion:
Use this to calculate how many "M16" mags a soldier has left. Take care when using count to determine how many units are left alive in a group: count units group player or count units groupname Will return the number of units the leader of the group thinks are alive. If some units have been killed out of sight of other members of the group then it may take sometime for this to be the actual numbers in the group. To determine exactly how many units are really alive in a group use: or
- Posted on Dec 15, 2014 - 00:01 (UTC)
-
count can be (ab)used for a very fast and simple check if at least one element in an array fulfills a certain condition:
This code will exit the count loop as soon as it finds an element fulfilling the condition, leaving the count with the value of 1, hence make the larger if-condition be true.
If no array element fulfills the condition, the count will be 0 and the if-condition will be false.
- Posted on Dec 29, 2014 - 21:23 (UTC)
- Quit loop at first fulfilled condition (same as above but faster):
- Posted on Jan 02, 2015 - 22:32 (UTC)
- Using exitWith inside a count loop will overwrite the default functionality and make count return whatever the exitWith returns:
- Posted on Aug 22, 2016 - 19:41 (UTC)
-
With the alternative syntax each iteration should result in an interior return of bool or nothing. Example:
lbAdd returns a number, so this throws "Error Type Number, expected Bool". Tested in A2OA 1.63.131129
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.00
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Operation Flashpoint: Elite: Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Arrays
- Command Group: Strings
- Command Group: Config
- Command Group: HashMap