BIS fnc counter: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \[\[Category:\{\{Name|[a-z0-9]+\}\}: Functions\|\{\{uc:[a-zA-Z0-9]+\}\}\]\]" to "")
m (Some wiki formatting)
 
(3 intermediate revisions by the same user not shown)
Line 6: Line 6:
|game2= arma3
|game2= arma3
|version2= 0.50
|version2= 0.50
|arg= global
|eff= local


|gr1= Systems
|gr1= Systems


|descr= <pre>/*
|descr= Modify the given counter, create it if does not exist.
{{Feature|important|It is '''not''' possible to broadcast the counter (like [[setVariable]] does) with this function.}}


Description:
|s1= [varName, add, modulo] call [[BIS_fnc_counter]]
Modify the given counter (create it if doesn't exist)


Parameter(s):
|p1= varName: [[String]] or [[Array]] format [varName, namespace] - default namespace is [[missionNamespace]]
_this select 0:
STRING - variable name of counter
ARRAY in format [variableName,nameSpace], where nameSpace can be object, group or missionNameSpace/uiNameSpace
_this select 1 (Optional): NUMBER - added value
_this select 2 (Optional): NUMBER - modulo value


Returns:
|p2= add: [[Number]] - (Optional, default 0) the value to be added
NUMBER - counter's value
*/</pre>


{{Wiki|placeholder}}
|p3= modulo: [[Number]] - (Optional, default -1) the [[mod]]ulo to use for counter cycle, applied after the addition
|s1= <!-- [] call [[BIS_fnc_counter]] -->


|r1=
|r1= [[Number]] the new counter value


|x1=
|x1= <sqf>[["TAG_Score", player], 1] call BIS_fnc_counter;</sqf>


|seealso= [[BIS_fnc_deleteCounter]]
|seealso= [[BIS_fnc_deleteCounter]]
}}
}}
||

Latest revision as of 16:43, 11 April 2024

Hover & click on the images for description

Description

Description:
Modify the given counter, create it if does not exist.
It is not possible to broadcast the counter (like setVariable does) with this function.
Execution:
call
Groups:
Systems

Syntax

Syntax:
[varName, add, modulo] call BIS_fnc_counter
Parameters:
varName: String or Array format [varName, namespace] - default namespace is missionNamespace
add: Number - (Optional, default 0) the value to be added
modulo: Number - (Optional, default -1) the modulo to use for counter cycle, applied after the addition
Return Value:
Number the new counter value

Examples

Example 1:
[["TAG_Score", player], 1] call BIS_fnc_counter;

Additional Information

See also:
BIS_fnc_deleteCounter

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