getVariable
Jump to navigation
Jump to search
Description
- Description:
- Return the value of variable in the variable space of given object or location.
All available data types combinations:- Namespace getVariable String
- Namespace getVariable Array (since a2 1.60)
- Object getVariable String
- Object getVariable Array
- Group getVariable String
- Group getVariable Array
- Team_Member getVariable String
- Team_Member getVariable Array
- Task getVariable String
- Location getVariable String
- Control getVariable String (since Arma 3 v1.55.133553)
- Control getVariable Array (since Arma 3 v1.55.133553)
- Display getVariable String (since Arma 3 v1.55.133553)
- Display getVariable Array (since Arma 3 v1.55.133553)
- Groups:
- Uncategorised
Syntax
- Syntax:
- varspace getVariable name
- Parameters:
- varspace: Namespace, Object, Display, Control, Group, Location, Task or Team Member
- name: String - Variable name that was defined in setVariable (Case sensitive)
- 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 or Team Member
- name: String - Variable name that was defined in setVariable (Case sensitive)
- defaultValue: Anything - Value to return if variable doesn't exist
- Return Value:
- Anything or defaultValue if the variable doesn't exist.
Note: If the varspace is nonexistent (objNull, grpNull, controlNull ..etc), return is nil
Examples
- Example 1:
_thePublicVariable = _myTruck getVariable "myPublicVariable";
- Example 2:
_aLocalVariable = _myTruck getVariable ["myLocalVariable", ["Not set", _var]] select 1;
- Example 3:
for "_i" from 0 to 5 do { _car = missionNamespace getVariable ("car" + str _i); _car setDamage 0; };
Sets damage of car0, car1, ..., car5 to 0.- Example 4:
myMissionVar = 2015; missionNamespace getVariable "myMissionVar";//Returns 2015
- Example 5:
- WARNING when using dynamic default value:
missionNamespace getVariable ["var", 123 call fnc_abc]; /// fnc_abc is always called even when var is defined
- Example 6:
- 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:
- setVariableallVariables
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
Notes
Bottom Section
- Posted on August 13, 2016 - 17:13 (UTC)
- Ebay
-
Warning: the alternative syntax returns undefined when the varspace is an object and that object is null. Example:
_test = objNull getVariable ["test","0"]; systemChat _test;
Errors because _test is undefined. Tested in A2OA 1.63.131129
Categories:
- Name template usage error
- Scripting Commands
- Introduced with Arma version 1.00
- Arma: New Scripting Commands
- Arma: Scripting Commands
- Command Group: Uncategorised
- Scripting Commands ArmA
- Command Group: Variables
- Command Group: Locations
- Scripting Commands ArmA2
- Scripting Commands Arma 3
- Scripting Commands Take On Helicopters