Difference between revisions of "getVariable"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Some wiki formatting)
 
(118 intermediate revisions by 17 users not shown)
Line 1: Line 1:
{{Command|= Comments
+
{{RV|type=command
____________________________________________________________________________________________
 
  
| arma |= Game name
+
|game1= arma1
 +
|version1= 1.00
  
|1.00|= Game version
+
|game2= arma2
____________________________________________________________________________________________
+
|version2= 1.00
  
| Return the value of variable in the variable space of given object or location. |= Description
+
|game3= arma2oa
____________________________________________________________________________________________
+
|version3= 1.50
  
| object '''getVariable''' name |= Syntax
+
|game4= tkoh
 +
|version4= 1.00
  
|p1= object: [[Object]] or [[Location]] |= Parameter 1
+
|game5= arma3
 +
|version5= 0.50
  
|p2= name: [[String]] - Variable name that was defined in [[setVariable]] ('''Case sensitive''') |= Parameter 2
+
|arg= global
  
| [[Any Value]] |= Return value
+
|gr1= Variables
____________________________________________________________________________________________
+
|gr2= Namespaces
|x1= <code>_aVariable <nowiki>=</nowiki> _myTruck getVariable "myVariable";</code> |= Example 1
+
|gr3= Multiplayer
  
| [[setVariable]], [[getVariable (VBS2)]] |= See also
+
|descr= Returns the value of variable in the variable space assigned to various data types.
 +
All available data types combinations:
 +
{{{!}} class="wikitable"
 +
!colspan="2"{{!}}Primary syntax ([[String]]) !! colspan="2"{{!}}Alternative syntax ([[Array]])
 +
{{!}}-
 +
{{!}}'''Code'''
 +
{{!}}'''Since'''
 +
{{!}}'''Code'''
 +
{{!}}'''Since'''
 +
{{!}}-
 +
{{!}} [[Namespace]] getVariable [[String]] {{!}}{{!}} - {{!}}{{!}} [[Namespace]] getVariable [[Array]] {{!}}{{!}} {{arma2oa}} v1.60
 +
{{!}}-
 +
{{!}} [[Object]] getVariable [[String]] {{!}}{{!}} - {{!}}{{!}} [[Object]] getVariable [[Array]] {{!}}{{!}} -
 +
{{!}}-
 +
{{!}} [[Group]] getVariable [[String]] {{!}}{{!}} - {{!}}{{!}} [[Group]] getVariable [[Array]] {{!}}{{!}} -
 +
{{!}}-
 +
{{!}} [[Team Member]] getVariable [[String]] {{!}}{{!}} - {{!}}{{!}} [[Team Member]] getVariable [[Array]] {{!}}{{!}} -
 +
{{!}}-
 +
{{!}} [[Task]] getVariable [[String]] {{!}}{{!}} - {{!}}{{!}} [[Task]] getVariable [[Array]] {{!}}{{!}} {{arma3}} v1.68
 +
{{!}}-
 +
{{!}} [[Location]] getVariable [[String]] {{!}}{{!}} - {{!}}{{!}} [[Location]] getVariable [[Array]] {{!}}{{!}} {{arma3}} v1.68
 +
{{!}}-
 +
{{!}} [[Control]] getVariable [[String]] {{!}}{{!}} - {{!}}{{!}} [[Control]] getVariable [[Array]] {{!}}{{!}} {{arma3}} v1.56
 +
{{!}}-
 +
{{!}} [[Display]] getVariable [[String]] {{!}}{{!}} {{arma3}} v1.56 {{!}}{{!}} [[Display]] getVariable [[Array]] {{!}}{{!}} {{arma3}} v1.56
 +
{{!}}}
  
 +
{{Feature|important|When variable is [[setVariable|set]] on a [[Task]], it is not actually set on the task itself, but on the FSM attached to the task.<br>
 +
If there is no FSM, [[getVariable]] will not work.}}
 +
{{Feature| arma3 | In the case of Alt Syntax usage in {{arma3}}, ''defaultValue'' will be returned if:
 +
* Requested variable is either undefined or [[nil]]
 +
* Variable namespace is null ([[objNull]], [[grpNull]], etc.)}}
 +
 +
|s1= varspace [[getVariable]] name
 +
 +
|p1= varspace: [[Namespace]], [[Object]], [[Display]], [[Control]], [[Group]], [[Location]], [[Task]], [[Team Member]], [[Display]], [[Control]]
 +
 +
|p2= name: [[String]] - variable name in given namespace
 +
 +
|r1= [[Anything]] or [[Nothing]] if the variable doesn't exist
 +
 +
|s2= varspace [[getVariable]] [name, defaultValue]
 +
 +
|p21= varspace: [[Namespace]], [[Object]], [[Display]], [[Control]], [[Group]], [[Location]], [[Task]], [[Team Member]], [[Display]], [[Control]]
 +
 +
|p22= name: [[String]] - variable name in given namespace
 +
 +
|p23= defaultValue: [[Anything]] - value to return if variable doesn't exist {{Feature|warning|A dynamic ''defaultValue'' e.g <sqf inline>random 500</sqf> will always be executed, even if the variable is defined.}}
 +
 +
|r2= [[Anything]] - current value of the variable or ''defaultValue'' if the variable doesn't exist.
 +
 +
|x1= <sqf>private _variable = myTruck getVariable "myVariable"; // returns nil if "myVariable" is not set</sqf>
 +
 +
|x2= <sqf>private _variable = myTruck getVariable ["myVariable", 50]; // returns 50 if "myVariable" is not set</sqf>
 +
 +
|x3= <sqf>
 +
for "_i" from 0 to 5 do
 +
{
 +
_car = missionNamespace getVariable ("car" + str _i);
 +
_car setDamage 0;
 +
}; // Set damage of car0..car5 to 0
 +
</sqf>
 +
 +
|x4= <sqf>
 +
myMissionVar = 2015;
 +
missionNamespace getVariable "myMissionVar"; // returns 2015
 +
</sqf>
 +
 +
|x5= Get current value of a variable and if it is undefined, define it and get the defined value:
 +
<sqf>
 +
private _var = missionNamespace getVariable "varName";
 +
if (isNil "_var") then
 +
{
 +
missionNamespace setVariable ["varName", 123];
 +
_var = 123;
 +
};
 +
// _var here will contain current value of the variable varName
 +
</sqf>
 +
 +
|seealso= [[setVariable]] [[allVariables]] [[getFSMVariable]]
 
}}
 
}}
  
<h3 style="display:none">Notes</h3>
+
{{Note
<dl class="command_description">
+
|user= Ebay
<!-- Note Section BEGIN -->
+
|timestamp= 20160813171300
Returns [[Nothing]] if the variable doesn't exists.<br>
+
|text= '''NOTE: {{arma2}} only! In {{arma3}} this will return default value:'''
Returns [[Anything]] if the object is undefined.<br>
+
Warning: the alternative syntax returns undefined when the namespace is an object and that object is null. Example:<br>
There is a third parameter of type Boolean that when set to True makes the variable global. If a variable was set on a playable unit, even with AI disabled the variable will be present when a JIP player controls the same unit.
+
<sqf>_test = objNull getVariable ["test", "0"];
<!-- Note Section END -->
+
systemChat _test;</sqf>
</dl>
+
Errors because _test is undefined. Tested in {{arma2oa}} 1.63.131129
 +
}}
  
<h3 style="display:none">Bottom Section</h3>
+
{{Note
[[Category:Scripting Commands|GETVARIABLE]]
+
|user= AgentRev
[[Category:Scripting Commands ArmA|GETVARIABLE]]
+
|timestamp= 20170831032900
[[Category:Command_Group:_Variables|{{uc:{{PAGENAME}}}}]]
+
|text= You can do typechecking using [[param]]:
[[Category:Command_Group:_Locations|{{uc:{{PAGENAME}}}}]]
+
<sqf>private _myVar = [player getVariable "myVar"] param [0, "", [""]];</sqf>
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
+
and [[params]]:
 +
<sqf>[player getVariable "myVar"] params [["_myVar", "", [""]]];</sqf>
 +
}}

Latest revision as of 02:34, 19 July 2022

Hover & click on the images for description

Description

Description:
Returns the value of variable in the variable space assigned to various data types. All available data types combinations:
Primary syntax (String) Alternative syntax (Array)
Code Since Code Since
Namespace getVariable String - Namespace getVariable Array Arma 2: Operation Arrowhead v1.60
Object getVariable String - Object getVariable Array -
Group getVariable String - Group getVariable Array -
Team Member getVariable String - Team Member getVariable Array -
Task getVariable String - Task getVariable Array Arma 3 v1.68
Location getVariable String - Location getVariable Array Arma 3 v1.68
Control getVariable String - Control getVariable Array Arma 3 v1.56
Display getVariable String Arma 3 v1.56 Display getVariable Array Arma 3 v1.56
When variable is set on a Task, it is not actually set on the task itself, but on the FSM attached to the task.
If there is no FSM, getVariable will not work.
Arma 3
In the case of Alt Syntax usage in Arma 3, defaultValue will be returned if:
  • Requested variable is either undefined or nil
  • Variable namespace is null (objNull, grpNull, etc.)
Groups:
VariablesNamespacesMultiplayer

Syntax

Syntax:
varspace getVariable name
Parameters:
varspace: Namespace, Object, Display, Control, Group, Location, Task, Team Member, Display, Control
name: String - variable name in given namespace
Return Value:
Anything or Nothing if the variable doesn't exist

Alternative Syntax

Syntax:
varspace getVariable [name, defaultValue]
Parameters:
varspace: Namespace, Object, Display, Control, Group, Location, Task, Team Member, Display, Control
name: String - variable name in given namespace
defaultValue: Anything - value to return if variable doesn't exist
A dynamic defaultValue e.g random 500 will always be executed, even if the variable is defined.
Return Value:
Anything - current value of the variable or defaultValue if the variable doesn't exist.

Examples

Example 1:
private _variable = myTruck getVariable "myVariable"; // returns nil if "myVariable" is not set
Example 2:
private _variable = myTruck getVariable ["myVariable", 50]; // returns 50 if "myVariable" is not set
Example 3:
for "_i" from 0 to 5 do { _car = missionNamespace getVariable ("car" + str _i); _car setDamage 0; }; // Set damage of car0..car5 to 0
Example 4:
myMissionVar = 2015; missionNamespace getVariable "myMissionVar"; // returns 2015
Example 5:
Get current value of a variable and if it is undefined, define it and get the defined value:
private _var = missionNamespace getVariable "varName"; if (isNil "_var") then { missionNamespace setVariable ["varName", 123]; _var = 123; }; // _var here will contain current value of the variable varName

Additional Information

See also:
setVariable allVariables getFSMVariable

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
Ebay
Posted on Aug 13, 2016 - 17:13 (UTC)
NOTE: Arma 2 only! In Arma 3 this will return default value: Warning: the alternative syntax returns undefined when the namespace is an object and that object is null. Example:
_test = objNull getVariable ["test", "0"]; systemChat _test;
Errors because _test is undefined. Tested in Arma 2: Operation Arrowhead 1.63.131129
AgentRev
Posted on Aug 31, 2017 - 03:29 (UTC)
You can do typechecking using param:
private _myVar = [player getVariable "myVar"] param [0, "", [""]];
and params:
[player getVariable "myVar"] params [["_myVar", "", [""]]];