getArray: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Take[ _]On[ _]Helicopters(\|.*)?\]\]" to "{{GameCategory|tkoh|Scripting Commands}}")
m (Some wiki formatting)
 
(68 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma1 |Game name=
|game1= arma1
|version1= 1.00


|gr1= Config |GROUP1=
|game2= arma2
|version2= 1.00


|game3= arma2oa
|version3= 1.50


|game4= tkoh
|version4= 1.00


|1.00|Game version=
|game5= arma3
____________________________________________________________________________________________
|version5= 0.50


| Extract array from config entry. |DESCRIPTION=
|gr1= Config
____________________________________________________________________________________________


| [[Array]] <nowiki>=</nowiki> '''getArray''' config |SYNTAX=
|descr= Extract array from config entry.


|p1= config: [[Config]] |PARAMETER1=
|s1= [[getArray]] config


| [[Array]] |RETURNVALUE=
|p1= config: [[Config]]
____________________________________________________________________________________________
 
|x1= <pre>_array = getArray (configFile >> "CfgVehicles" >> "Thing" >> "threat")</pre> |EXAMPLE1=
____________________________________________________________________________________________


| [[configFile]], [[config/name]], [[configName]], [[count]], [[getText]], [[getNumber]], [[inheritsFrom]], [[isArray]], [[isClass]], [[isNumber]], [[isText]], [[select]] |SEEALSO=
|r1= [[Array]]


|x1= <sqf>_array = getArray (configFile >> "CfgVehicles" >> "Thing" >> "threat");</sqf>
|seealso= [[configFile]] [[a / b]] [[configName]] [[count]] [[getText]] [[getNumber]] [[inheritsFrom]] [[isArray]] [[isClass]] [[isNumber]] [[isText]] [[select]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= ffur2007slx2_5
<!-- Note Section BEGIN -->
|timestamp= 20140328075200
<dd class="notedate">Posted on Mar 28, 2014 - 07:52
|text= ({{arma3}} 1.14) It's recommended to use [[BIS_fnc_getCfgData]] or [[BIS_fnc_returnConfigEntry]] to get variable cfg data rather than conditioning via [[isNumber]], [[isText]], [[isArray]], [[getNumber]], [[getText]] and [[getArray]] combination.<br>
<dt class="note">[[User:ffur2007slx2_5|ffur2007slx2_5]]<dd class="note">
(ArmA3 1.14) It's recommended to use [[BIS_fnc_GetCfgData]] or [[BIS_fnc_returnConfigEntry]] to get variable cfg data rather than conditioning via [[isNumber]], [[isText]], [[isArray]], [[getNumber]], [[getText]] and [[getArray]] combination.<br>
Traditional workaround:
Traditional workaround:
<code>
<sqf>
_cfg = [[configFile]] >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type"
_cfg = configFile >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type";
[[switch]] ( [[true]] ) [[do]]
switch ( true ) do
{
{
[[case]] ([[isNumber]] _cfg): {[[getNumber]] _cfg};
case (isNumber _cfg): {getNumber _cfg};
[[case]] ([[isText]] _cfg): {[[getText]] _cfg};
case (isText _cfg): {getText _cfg};
[[case]] ([[isArray]] _cfg): {[[getArray]] _cfg;};
case (isArray _cfg): {getArray _cfg;};
[[default]] { nil };
default { nil };
};
};
</code>
</sqf>
'''Recommended workaround:'''
'''Recommended workaround:'''
<code>
<sqf>(configFile >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type") call BIS_fnc_getCfgData;</sqf>
([[configFile]] >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type") [[call]] [[BIS_fnc_GetCfgData]];
To return default value once entry was not found, we can use [[BIS_fnc_returnConfigEntry]] instead of [[BIS_fnc_getCfgData]].
</code>
<sqf>[(configFile >> "CannonFire" >> "LightExp"),"lifeTime",0] call BIS_fnc_returnConfigEntry; // 0.5</sqf>
To return default value once entry was not found, we can use [[BIS_fnc_returnConfigEntry]] instead of [[BIS_fnc_GetCfgData]].
}}
<code>
[([[configFile]] >> "CannonFire" >> "LightExp"),"lifeTime",0] [[call]] [[BIS_fnc_returnConfigEntry]];//0.5
</code>
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
{{Note
[[Category:Scripting Commands|GETARRAY]]
|user= demellion
{{GameCategory|arma1|Scripting Commands}}
|timestamp= 20180112194800
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
|text= There is special behaviour if you try to read a description.ext config entry [[Array]] that contains a [[Boolean]].<br>
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}
 
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on January 12, 2018 - 19:48 (UTC)</dd>
<dt class="note">[[User:demellion|demellion]]</dt>
<dd class="note">
There is special behaviour if you try to read a description.ext config entry [[Array]] that contains a [[Boolean]].<br>
Getting array in '''MP''' will result in [[Number]], while '''SP''' will return [[String]].
Getting array in '''MP''' will result in [[Number]], while '''SP''' will return [[String]].
<code>// SP with false in array
<sqf>
[[getArray]] ([[missionConfigFile]] >> "someClass" >> "someArray") // -> "false"
// SP with false in array
getArray (missionConfigFile >> "someClass" >> "someArray") // -> "false"


// MP with false in array
// MP with false in array
[[getArray]] ([[missionConfigFile]] >> "someClass" >> "someArray") // -> 0</code>
getArray (missionConfigFile >> "someClass" >> "someArray") // -> 0
</dd>
</sqf>
</dl>
}}
<!-- DISCONTINUE Notes -->

Latest revision as of 23:30, 13 May 2023

Logo A1 black.png 1.00Logo A2.png 1.00A2 OA Logo.png 1.50tkoh logo small.png 1.00Arma 3 logo black.png 0.50
Hover & click on the images for description

Description

Description:
Extract array from config entry.
Groups:
Config

Syntax

Syntax:
getArray config
Parameters:
config: Config
Return Value:
Array

Examples

Example 1:
_array = getArray (configFile >> "CfgVehicles" >> "Thing" >> "threat");

Additional Information

See also:
configFile a / b configName count getText getNumber inheritsFrom isArray isClass isNumber isText select

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 - c
Posted on Mar 28, 2014 - 07:52 (UTC)
(Arma 3 1.14) It's recommended to use BIS_fnc_getCfgData or BIS_fnc_returnConfigEntry to get variable cfg data rather than conditioning via isNumber, isText, isArray, getNumber, getText and getArray combination.
Traditional workaround:
_cfg = configFile >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type"; switch ( true ) do { case (isNumber _cfg): {getNumber _cfg}; case (isText _cfg): {getText _cfg}; case (isArray _cfg): {getArray _cfg;}; default { nil }; };
Recommended workaround:
(configFile >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type") call BIS_fnc_getCfgData;
To return default value once entry was not found, we can use BIS_fnc_returnConfigEntry instead of BIS_fnc_getCfgData.
[(configFile >> "CannonFire" >> "LightExp"),"lifeTime",0] call BIS_fnc_returnConfigEntry; // 0.5
demellion - c
Posted on Jan 12, 2018 - 19:48 (UTC)
There is special behaviour if you try to read a description.ext config entry Array that contains a Boolean.
Getting array in MP will result in Number, while SP will return String.
// SP with false in array getArray (missionConfigFile >> "someClass" >> "someArray") // -> "false" // MP with false in array getArray (missionConfigFile >> "someClass" >> "someArray") // -> 0
Retrieved from "https://community.bistudio.com/wiki?title=getArray&oldid=341204"