{"name":"configFile","operator":null,"title":"configFile","type":"command","url":"https://community.bistudio.com/wiki/configFile","revid":369418,"updated":"2024-09-03T18:48:49Z","groups":["Config"],"status":"ok","replaced_by":[],"games":[{"game":"arma1","name":"Armed Assault","version":"1.00"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma1","name":"Armed Assault","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Return root of config entries hierarchy.","syntaxes":[{"syntax":"configFile","since":null,"effect":null,"exec":null,"params":[],"returns":{"type":"Config","types":["Config"],"description":null,"text":"Config"},"form":"nullary","operator":null,"left":null,"right":null}],"examples":[{"text":"```sqf\n_isMyClassActive = isClass (configFile >> \"CfgPatches\" >> \"MyClass\");\n```","code":["_isMyClassActive = isClass (configFile >> \"CfgPatches\" >> \"MyClass\");"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["missionConfigFile","campaignConfigFile"],"notes":[{"user":"ffur2007slx2_5","date":"2014-07-19T20:08:00Z","text":"Arma 3 v1.24 It is recommended to use configClasses instead of BIS_fnc_getCfgSubClasses and BIS_fnc_uniqueClasses on subclasses collection or conditional selection.\n\n```sqf\n_faces = \"true\" configClasses (configFile >> \"CfgFaces\");\n// same as:\n_faces = (configfile >> \"CfgFaces\") call BIS_fnc_getCfgSubClasses;\n```\n\n```sqf\n//Extract all animals:\nanimals = \"configName _x isKindOf 'animal'\" configClasses (configFile >> \"CfgVehicles\");\n// same as:\nanimals = [];\n[\n    configFile >> \"CfgVehicles\",\n    {\n        if ((configName _this) isKindOf \"animal\") then {\n            animals set [count animals, _this]\n        }\n    }\n] call BIS_fnc_uniqueClasses;\n```\n\nReturn nested subclasses, currently still BIS_fnc_returnChildren\n\n```sqf\n// return all nested config classes\n[configFile >> \"CfgFaces\", 1, true, true] call BIS_fnc_returnChildren;\n```"}],"categories":["ArmA: Armed Assault: New Scripting Commands","ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Config","Introduced with Armed Assault version 1.00","Scripting Commands","Take On Helicopters: Scripting Commands"]}