BIS fnc configPath: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\{\{ *cc*\| *([^}]+) *\}\}" to "// $1")
m (Some wiki formatting)
 
Line 6: Line 6:
|gr1= Configs
|gr1= Configs


|descr=Returns config path to given entry in given format.
|descr= Returns config path to given entry in given format.


|s1= [config, format, strict] call [[BIS_fnc_configPath]]
|s1= [config, format, strict] call [[BIS_fnc_configPath]]


|p1= config: [[Array]], [[String]] or [[Config]] - input config
|p1= config: [[Array]], [[String]] or [[Config]] - input config
|p2= format (Optional): [[Array]], [[String]] or [[Config]] - desired format of output. Default: [[Array]], unless [[Array]] is input, then [[Config]] is returned (see Example 1)
 
|p3= strict (Optional): [[Boolean]] - by default the function will not attempt to construct a valid config before certain format conversions (see Example 2). Set this param to [[true]] to invoke the strict mode
|p2= format: [[Array]], [[String]] or [[Config]] - (Optional, default <sqf inline>[]</sqf> or <sqf inline>configNull</sqf> if ''config'' is [[Array]] - see {{Link|#Example 1}}) desired format of output
 
|p3= strict: [[Boolean]] - (Optional, default [[false]]) if false, the function will not attempt to construct a valid config before certain format conversions (see {{Link|#Example 2}}).
Set this param to [[true]] to invoke the strict mode


|r1= [[Array]], [[String]] or [[Config]]
|r1= [[Array]], [[String]] or [[Config]]
Line 18: Line 21:
|x1= <sqf>["configFile >> ""CfgVehicles"" >> ""Car"""] call BIS_fnc_configPath; // ["configFile","CfgVehicles","Car"]</sqf>
|x1= <sqf>["configFile >> ""CfgVehicles"" >> ""Car"""] call BIS_fnc_configPath; // ["configFile","CfgVehicles","Car"]</sqf>


|x2= <code><nowiki>[</nowiki>["mary", "had", "a", "little", "lamb"], ""] [[call]] [[BIS_fnc_configPath]]; // "mary >> ""had"" >> ""a"" >> ""little"" >> ""lamb"""</code>
|x2= <sqf>[["mary", "had", "a", "little", "lamb"], ""] call BIS_fnc_configPath; // "mary >> ""had"" >> ""a"" >> ""little"" >> ""lamb"""</sqf>


|x3= <code><nowiki>[</nowiki>["configFile","CfgVehicles","Car"]] [[call]] [[BIS_fnc_configPath]]; // bin\config.cpp/CfgVehicles/Car</code>
|x3= <sqf>[["configFile","CfgVehicles","Car"]] call BIS_fnc_configPath; // bin\config.cpp/CfgVehicles/Car</sqf>


|x4= <sqf>["bin\config.cpp/CfgVehicles/Car"] call BIS_fnc_configPath; // ["configFile","CfgVehicles","Car"]</sqf>
|x4= <sqf>["bin\config.cpp/CfgVehicles/Car"] call BIS_fnc_configPath; // ["configFile","CfgVehicles","Car"]</sqf>
Line 30: Line 33:
|x7= <sqf>["bin\config.cpp/CfgVehicles/Car", ""] call BIS_fnc_configPath; // "bin\config.cpp/CfgVehicles/Car"</sqf>
|x7= <sqf>["bin\config.cpp/CfgVehicles/Car", ""] call BIS_fnc_configPath; // "bin\config.cpp/CfgVehicles/Car"</sqf>


|x8= <code><nowiki>[</nowiki>["mary", "had", "a", "little", "lamb"], "", [[true]]] [[call]] [[BIS_fnc_configPath]]; // "" invalid config</code>
|x8= <sqf>[["mary", "had", "a", "little", "lamb"], "", true] call BIS_fnc_configPath; // "" invalid config</sqf>


|seealso= [[configHierarchy]]
|seealso= [[configHierarchy]]
}}
}}

Latest revision as of 16:34, 13 July 2022

Arma 3 logo black.png1.00
Hover & click on the images for description

Description

Description:
Returns config path to given entry in given format.
Execution:
call
Groups:
Configs

Syntax

Syntax:
[config, format, strict] call BIS_fnc_configPath
Parameters:
config: Array, String or Config - input config
format: Array, String or Config - (Optional, default [] or configNull if config is Array - see Example 1) desired format of output
strict: Boolean - (Optional, default false) if false, the function will not attempt to construct a valid config before certain format conversions (see Example 2). Set this param to true to invoke the strict mode
Return Value:
Array, String or Config

Examples

Example 1:
["configFile >> ""CfgVehicles"" >> ""Car"""] call BIS_fnc_configPath; // ["configFile","CfgVehicles","Car"]
Example 2:
[["mary", "had", "a", "little", "lamb"], ""] call BIS_fnc_configPath; // "mary >> ""had"" >> ""a"" >> ""little"" >> ""lamb"""
Example 3:
[["configFile","CfgVehicles","Car"]] call BIS_fnc_configPath; // bin\config.cpp/CfgVehicles/Car
Example 4:
["bin\config.cpp/CfgVehicles/Car"] call BIS_fnc_configPath; // ["configFile","CfgVehicles","Car"]
Example 5:
[configFile >> "CfgVehicles" >> "Car", ""] call BIS_fnc_configPath; // "configFile >> ""CfgVehicles"" >> ""Car"""
Example 6:
["bin\config.cpp/CfgVehicles/Car", "", true] call BIS_fnc_configPath; // "configFile >> ""CfgVehicles"" >> ""Car"""
Example 7:
["bin\config.cpp/CfgVehicles/Car", ""] call BIS_fnc_configPath; // "bin\config.cpp/CfgVehicles/Car"
Example 8:
[["mary", "had", "a", "little", "lamb"], "", true] call BIS_fnc_configPath; // "" invalid config

Additional Information

See also:
configHierarchy

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
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_configPath&oldid=327973"