Difference between revisions of "configFile"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (Some wiki formatting)
 
(64 intermediate revisions by 3 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 root of config entries hierarchy.<br />
+
|game3= arma2oa
See [[AllInOne Config]] for a full config extract as example. |DESCRIPTION=
+
|version3= 1.50
____________________________________________________________________________________________
 
  
| [[Config]] <nowiki>=</nowiki> '''configFile''' |SYNTAX=
+
|game4= tkoh
 +
|version4= 1.00
  
| [[Config]] |RETURNVALUE=
+
|game5= arma3
____________________________________________________________________________________________
+
|version5= 0.50
  
|x1= <code>_isMyClassActive = [[isClass]] ([[configFile]] / "CfgPatches" / "MyClass");</code> |EXAMPLE1=
+
|gr1= Config
____________________________________________________________________________________________
 
  
| [[configClasses]], [[configProperties]], [[missionConfigFile]], [[campaignConfigFile]], [[config/name]], [[config greater greater name|config >> name]], [[configName]], [[count]], [[getArray]], [[getText]], [[getNumber]], [[inheritsFrom]], [[isArray]], [[isClass]], [[isNumber]], [[isText]], [[select]], [[configHierarchy]], [[getMissionConfigValue]] |SEEALSO=
+
|descr= Return root of config entries hierarchy.
  
 +
|s1= [[configFile]]
 +
 +
|r1= [[Config]]
 +
 +
|x1= <sqf>_isMyClassActive = isClass (configFile >> "CfgPatches" >> "MyClass");</sqf>
 +
 +
|seealso= [[missionConfigFile]] [[campaignConfigFile]]
 
}}
 
}}
  
<h3 style="display:none">Notes</h3>
+
{{Note
<dl class="command_description">
+
|user= ffur2007slx2_5
<!-- Note Section BEGIN -->
+
|timestamp= 20140719200800
<dd class="notedate">Posted on Jul 19, 2014 - 20:08
+
|text= {{GVI|arma3|1.24}} It is recommended to use [[configClasses]] instead of [[BIS_fnc_getCfgSubClasses]] and [[BIS_fnc_uniqueClasses]] on subclasses collection or conditional selection.
<dt class="note">'''[[User:ffur2007slx2_5|ffur2007slx2_5]]'''<dd class="note">
+
<sqf>_faces = "true" configClasses (configFile >> "CfgFaces");
(ArmA3 1.24) It is recommended to use [[configClasses]] instead of [[BIS_fnc_getCfgSubClasses]] and [[BIS_fnc_uniqueClasses]] on subclasses collection or conditional selection.
+
// same as:
<code>
+
_faces = (configfile >> "CfgFaces") call BIS_fnc_getCfgSubClasses;</sqf>
_faces = "[[true]]" [[configClasses]] ([[configFile]] >> "Cfgfaces");
+
<sqf>//Extract all animals:
//same as: _faces = (configfile >> "CfgFaces") [[call]] [[BIS_fnc_getCfgSubClasses]];
+
animals = "configName _x isKindOf 'animal'" configClasses (configFile >> "CfgVehicles");
</code>
+
// same as:
<code>
+
animals = [];
//Extract all animals:
+
[
animals = "(([[configName]] _x) [[isKindOf]] 'animal')" [[configClasses]] ([[configFile]] >> "CfgVehicles");
+
configFile >> "CfgVehicles",
/*same as:  
+
{
aniamls = [];
+
if ((configName _this) isKindOf "animal") then {
[([[configFile]] >> "CfgVehicles"),{
+
animals set [count animals, _this]
[[if]] (([[configName]] _this) [[isKindOf]] “animal”) [[then]] {
+
}
  animals [[set]] [ [[count]] animals, _this]
+
}
  }
+
] call BIS_fnc_uniqueClasses;
}
+
</sqf>
] [[call]] [[BIS_fnc_uniqueClasses]];*/
+
 
</code>
 
 
Return nested subclasses, currently still [[BIS_fnc_returnChildren]]
 
Return nested subclasses, currently still [[BIS_fnc_returnChildren]]
<code>
+
<sqf>
//Return all nested config classes.<br>
+
// return all nested config classes
[([[configFile]] >> "CfgFaces"),1, [[true]], [[true]] ] [[call]] [[BIS_fnc_returnChildren]];
+
[configFile >> "CfgFaces", 1, true, true] call BIS_fnc_returnChildren;
</code>
+
</sqf>
<!-- Note Section END -->
+
}}
</dl>
 
 
 
<h3 style="display:none">Bottom Section</h3>
 
 
 
[[Category:Scripting Commands|CONFIGFILE]]
 
[[Category:Scripting Commands ArmA|CONFIGFILE]]
 
[[Category:Command_Group:_System_Commands|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 

Latest revision as of 23:39, 17 September 2022

Hover & click on the images for description

Description

Description:
Return root of config entries hierarchy.
Groups:
Config

Syntax

Syntax:
configFile
Return Value:
Config

Examples

Example 1:
_isMyClassActive = isClass (configFile >> "CfgPatches" >> "MyClass");

Additional Information

See also:
missionConfigFile campaignConfigFile

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
ffur2007slx2_5
Posted on Jul 19, 2014 - 20:08 (UTC)
Arma 3 logo black.png1.24 It is recommended to use configClasses instead of BIS_fnc_getCfgSubClasses and BIS_fnc_uniqueClasses on subclasses collection or conditional selection.
_faces = "true" configClasses (configFile >> "CfgFaces"); // same as: _faces = (configfile >> "CfgFaces") call BIS_fnc_getCfgSubClasses;
//Extract all animals: animals = "configName _x isKindOf 'animal'" configClasses (configFile >> "CfgVehicles"); // same as: animals = []; [ configFile >> "CfgVehicles", { if ((configName _this) isKindOf "animal") then { animals set [count animals, _this] } } ] call BIS_fnc_uniqueClasses;
Return nested subclasses, currently still BIS_fnc_returnChildren
// return all nested config classes [configFile >> "CfgFaces", 1, true, true] call BIS_fnc_returnChildren;