setVariable: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "{{Command " to "{{RV|type=command ") |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
(28 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
{{RV|type=command | {{RV|type=command | ||
| arma1 | |game1= arma1 | ||
|version1= 1.00 | |||
|1.00 | |game2= arma2 | ||
|version2= 1.00 | |||
|game3= arma2oa | |||
|version3= 1.50 | |||
|game4= tkoh | |||
|version4= 1.00 | |||
|game5= arma3 | |||
|version5= 0.50 | |||
|arg= global | |arg= global | ||
|eff= local | |eff= local | ||
|gr1= Multiplayer | |gr1= Variables | ||
|gr2= Namespaces | |||
|gr3= Multiplayer | |||
|descr= Set variable to given value in the variable space of given element. Can be used to broadcast variables over the network. To remove a variable, set it to [[nil]] (see {{HashLink|#Example 5}}). | |||
{{Feature|warning| | |||
[[missionNamespace]], [[uiNamespace]], [[parsingNamespace]] and [[profileNamespace]] variables '''cannot''' be named as commands - e.g <sqf inline>missionNamespace setVariable ["west", 123];</sqf> will result in a {{hl|Reserved variable in expression}} error, [[west]] being a scripting command (other namespaces do not have such limitation). See also [[:Category:Scripting Commands|all available script commands]]. | |||
}} | |||
|mp= The variable space of the object is '''local to each client''' and '''by default''' changes are not broadcast - see the ''public'' parameter below. | |||
| | |s1= varspace [[setVariable]] [name, value, public] | ||
| | |p1= varspace: variable space in which variable can be set. Can be one of: | ||
{{Columns|2| | |||
* [[Namespace]] | * [[Namespace]] | ||
* [[Object]] | * [[Object]] | ||
* [[Group]] | * [[Group]] | ||
* [[Location]] ([[createLocation|scripted]] ones only) | |||
* {{GVI|arma2|1.00|size=0.75}} [[Team Member]] | |||
* [[Location]] ( | * {{GVI|arma2|1.00|size=0.75}} [[Task]] - ''value'' will actually be set on the [[Task]]'s [[FSM]] '''if''' it exists. | ||
* | * {{GVI|arma3|0.50|size=0.75}} [[Control]] | ||
* {{GVI|arma3|0.50|size=0.75}} [[Display]] | |||
|shrink= y | |||
{{ | }} | ||
|p2= name: [[String]] - variable name ([[Identifier]]) | |||
|p2 | |||
| [[ | |p3= value: [[Anything]] - variable value | ||
| | |p4= public - (Optional, default: [[false]]) can be one of: | ||
* [[Boolean]] - if set to [[true]], the variable is broadcast globally and is persistent ([[Multiplayer Scripting#Join In Progress|JIP]] compatible) {{Icon|globalEffect|32}} | |||
* [[Number]] - the variable is only set on the client with the given [[Multiplayer Scripting#Machine network ID|Machine network ID]]. If the number is negative, the variable is set on every client except for the one with the given ID. | |||
* [[Array]] of [[Number]]s - array of [[Multiplayer Scripting#Machine network ID|Machine network IDs]] | |||
This parameter is only available if the '''varspace''' parameter is a [[Namespace]], [[Object]] or [[Group]]. Furthermore, only the following [[:Category: Data Types|Data Types]] can be broadcast: | |||
{{{!}} class="wikitable" style="text-align: center" | |||
! Type | |||
{{!}} [[Number]] | |||
{{!}} [[Boolean]] | |||
{{!}} [[Object]] | |||
{{!}} [[Group]] | |||
{{!}} [[String]] | |||
{{!}} [[Text]] | |||
{{!}} [[Array]] | |||
{{!}} [[Code]] | |||
{{!}} [[Nothing]] ([[nil]]) | |||
{{!}} [[HashMap]] | |||
{{!}}- | |||
! Since | |||
{{!}} {{GVI|ofp|1.34}} | |||
{{!}} {{GVI|ofp|1.34}} | |||
{{!}} {{GVI|ofp|1.34}} | |||
{{!}} {{GVI|ofp|1.34}} | |||
{{!}} {{GVI|arma1|1.00}} | |||
{{!}} {{GVI|arma1|1.00}} | |||
{{!}} {{GVI|arma1|1.09}} | |||
{{!}} {{GVI|arma1|1.09}} | |||
{{!}} {{GVI|arma3|1.26}} | |||
{{!}} {{GVI|arma3|2.02}} | |||
{{!}}} | |||
|p4since= arma2 1.00 | |||
| | |r1= [[Nothing]] | ||
|x1= < | |x1= <sqf>_myTruck setVariable ["TAG_myPublicVariable", 123, true];</sqf> | ||
|x2= < | |x2= <sqf>_myTruck setVariable ["TAG_myLocalVariable", ["321", _var], owner driver _myTruck];</sqf> | ||
|x3= < | |x3= <sqf>missionNamespace setVariable ["TAG_myName", "Brian"]; | ||
hint TAG_myName; // hints "Brian"</sqf> | |||
|x4= Get current value of a variable | |x4= Get the current value of a variable or, if it is undefined, define it and then get the value: | ||
<sqf>private _var = missionNamespace getVariable "VarName"; | |||
{ | if (isNil "_var") then { | ||
_var = 123; | _var = 123; | ||
missionNamespace setVariable ["VarName", _var]; | |||
}; | }; | ||
// _var | // _var now contains the current value of the missionNamespace's variable varName</sqf> | ||
| | |x5= Remove {{hl|TAG_myPublicVariable}} from {{hl|_myTruck}} (globally): | ||
<sqf>_myTruck setVariable ["TAG_myPublicVariable", nil, true];</sqf> | |||
| [[getVariable]] | |seealso= [[getVariable]] [[allVariables]] [[setFSMVariable]] | ||
}} | }} | ||
{{Note | |||
|user= Killswitch | |||
|timestamp= 20070818095100 | |||
|text= According to {{User|Suma}}, beginning with ArmA version 1.08: | |||
{{Feature|quote|[[setVariable]] now should work on any entity which can be targeted by AI, including soldier and game logic units. This includes most buildings, but not other static objects. | |||
'''Using it with buildings one should be aware the building may be discarded because of streaming'''. In such case the variable space is lost. When used for buildings, the storage should therefore be considered non-reliable.|{{User|Suma}}}} | |||
}} | |||
{{Note | |||
|user= Commy2 | |||
|timestamp= 20151209201800 | |||
|text= This command does not work with CfgAmmo or CfgNonAIVehicles objects, like bullets, mines or butterflies. | |||
}} | |||
{{Note | |||
|user= Leopard20 | |||
|timestamp= 20220323085950 | |||
|text= Since {{GVI|arma3|2.10}} [[setVariable]] works on CfgAmmo objects (such as bullets, missiles, grenades, mines, etc) as well. | |||
{{ | }} | ||
Revision as of 14:45, 25 July 2022
Description
- Description:
- Set variable to given value in the variable space of given element. Can be used to broadcast variables over the network. To remove a variable, set it to nil (see Example 5).
- Multiplayer:
- The variable space of the object is local to each client and by default changes are not broadcast - see the public parameter below.
- Groups:
- VariablesNamespacesMultiplayer
Syntax
- Syntax:
- varspace setVariable [name, value, public]
- Parameters:
- varspace: variable space in which variable can be set. Can be one of:
- name: String - variable name (Identifier)
- value: Anything - variable value
- since 1.00
- public - (Optional, default: false) can be one of:
- Boolean - if set to true, the variable is broadcast globally and is persistent (JIP compatible) GEGlobal
- Number - the variable is only set on the client with the given Machine network ID. If the number is negative, the variable is set on every client except for the one with the given ID.
- Array of Numbers - array of Machine network IDs
Type Number Boolean Object Group String Text Array Code Nothing (nil) HashMap Since 1.34 1.34 1.34 1.34 1.00 1.00 1.09 1.09 1.26 2.02 - Return Value:
- Nothing
Examples
- Example 1:
- Example 2:
- Example 3:
- Example 4:
- Get the current value of a variable or, if it is undefined, define it and then get the value:
private _var = missionNamespace getVariable "VarName"; if (isNil "_var") then { _var = 123; missionNamespace setVariable ["VarName", _var]; }; // _var now contains the current value of the missionNamespace's variable varName
- Example 5:
- Remove TAG_myPublicVariable from _myTruck (globally):
Additional Information
- See also:
- getVariable allVariables setFSMVariable
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 18, 2007 - 09:51 (UTC)
- According to Suma, beginning with ArmA version 1.08:
- Posted on Dec 09, 2015 - 20:18 (UTC)
- This command does not work with CfgAmmo or CfgNonAIVehicles objects, like bullets, mines or butterflies.
- Posted on Mar 23, 2022 - 08:59 (UTC)
- Since 2.10 setVariable works on CfgAmmo objects (such as bullets, missiles, grenades, mines, etc) as well.
Categories:
- Scripting Commands
- Introduced with Armed Assault version 1.00
- ArmA: Armed Assault: New 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: Variables
- Command Group: Namespaces
- Command Group: Multiplayer
- Scripting Commands: Local Effect