profileNamespace: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Take[ _]On[ _]Helicopters(\|.*)?\]\]" to "{{GameCategory|tkoh|Scripting Commands}}")
m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(35 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| TKOH |Game name=
|game1= tkoh
|version1= 1.00


|1.00|Game version=
|game2= arma2oa
|version2= 1.62


|gr1= Variables |GROUP1=
|game3= arma3
____________________________________________________________________________________________
|version3= 0.50


| Returns the global namespace attached to the active user profile. Use [[setVariable]] and [[getVariable]] to save and load data to and from this [[Namespace]]. A variable can be deleted by setting its value to [[nil]]. By default the variables set in this namespace will exist while the game is running. In order to make variables save permanently, use [[saveProfileNamespace]] before the game is over.
|gr1= Namespaces
The variables are stored next to the user profile in a file named ''myUsername.vars.GAMENAME'' (e.g. in the ''My Documents\Take On Helicopters'' folder). |DESCRIPTION=
|gr2= Variables
____________________________________________________________________________________________


| '''profileNamespace'''|SYNTAX=
|descr= Returns the global namespace attached to the active user profile. Use [[setVariable]] and [[getVariable]] to save and load data to and from this [[Namespace]]. A variable can be deleted by setting its value to [[nil]]. By default the variables set in this namespace will exist while the game is running, and variables are saved persistently when the game is closed. Saving can also be forced by using [[saveProfileNamespace]] to prevent data loss on e.g game crash.<br>
The variables are stored next to the user profile in a file named {{hl|myUsername.vars.GAMENAME}}.


| [[Namespace]] |RETURNVALUE=
|s1= [[profileNamespace]]
____________________________________________________________________________________________


|x1= <code>_namespace = '''profileNamespace''';</code> |Example1=
|r1= [[Namespace]]
|x2= <code>'''profileNamespace''' [[setVariable]] ["var_kills",10000];
_playerKills = '''profileNamespace''' [[getVariable]] "var_kills";</code> |=


| [[saveProfileNamespace]], [[missionNamespace]], [[uiNamespace]], [[parsingNamespace]], [[currentNamespace]], [[localNamespace]], [[allVariables]], [[with]], [[ArmA:_Editing#Forward_Compatibility|Forward Compatibility]] |SEEALSO=
|x1= <sqf>
profileNamespace setVariable ["TAG_kills", 10000];
// somewhere else in the code
_kills = profileNamespace getVariable ["TAG_kills", 0];
</sqf>


|seealso= [[saveProfileNamespace]] [[missionNamespace]] [[uiNamespace]] [[parsingNamespace]] [[currentNamespace]] [[localNamespace]] [[allVariables]] [[with]] [[ArmA:_Editing#Forward_Compatibility|Forward Compatibility]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Joris
<!-- Note Section BEGIN -->
|timestamp= 20111125173300
 
|text= The variables are loaded when the user profile is loaded or changed.
<dt class="note">Unknown
}}
<dd class="note">The variables are loaded when the user profile is loaded or changed.
 
<!-- Note Section END -->
</dl>
 
<h3 style="display:none">Bottom Section</h3>
 
{{GameCategory|tkoh|Scripting Commands}}
[[Category:Take On Helicopters: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
 
[[Category:Arma 2: Operation Arrowhead: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 19:43, 3 September 2024

Hover & click on the images for description

Description

Description:
Returns the global namespace attached to the active user profile. Use setVariable and getVariable to save and load data to and from this Namespace. A variable can be deleted by setting its value to nil. By default the variables set in this namespace will exist while the game is running, and variables are saved persistently when the game is closed. Saving can also be forced by using saveProfileNamespace to prevent data loss on e.g game crash.
The variables are stored next to the user profile in a file named myUsername.vars.GAMENAME.
Groups:
NamespacesVariables

Syntax

Syntax:
profileNamespace
Return Value:
Namespace

Examples

Example 1:
profileNamespace setVariable ["TAG_kills", 10000]; // somewhere else in the code _kills = profileNamespace getVariable ["TAG_kills", 0];

Additional Information

See also:
saveProfileNamespace missionNamespace uiNamespace parsingNamespace currentNamespace localNamespace allVariables with Forward Compatibility

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
Joris - c
Posted on Nov 25, 2011 - 17:33 (UTC)
The variables are loaded when the user profile is loaded or changed.