---
name: "getArray"
type: command
status: ok
groups: ["Config"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getArray
revid: 377159
updated: 2026-01-01T10:40:02Z
---

# getArray

*Command · Config · Arma 3 v0.50 · introduced in Armed Assault v1.00*

## Description

Extract array from config entry.

## Syntax

```sqf
getArray config
```

**Parameters:**

- `config`: [Config](../topics/Config.md)

**Returns:** [Array](../topics/Array.md) of [Anything](../topics/Anything.md)

## Examples

### Example 1

```sqf
_array = getArray (configFile >> "CfgVehicles" >> "Thing" >> "threat");
```

## See also

[configFile](../commands/configFile.md) · [a / b](../commands/a_~2F_b.md) · [configName](../commands/configName.md) · [count](../commands/count.md) · [getText](../commands/getText.md) · [getNumber](../commands/getNumber.md) · [inheritsFrom](../commands/inheritsFrom.md) · [isArray](../commands/isArray.md) · [isClass](../commands/isClass.md) · [isNumber](../commands/isNumber.md) · [isText](../commands/isText.md) · [select](../commands/select.md)

## Community notes

**ffur2007slx2_5** — 2014-03-28

(Arma 3 1.14) It's recommended to use [BIS_fnc_getCfgData](../functions/BIS_fnc_getCfgData.md) or [BIS_fnc_returnConfigEntry](../functions/BIS_fnc_returnConfigEntry.md) to get variable cfg data rather than conditioning via [isNumber](../commands/isNumber.md), [isText](../commands/isText.md), [isArray](../commands/isArray.md), [getNumber](../commands/getNumber.md), [getText](../commands/getText.md) and [getArray](../commands/getArray.md) combination.

Traditional workaround:

```sqf
_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:**

```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](../functions/BIS_fnc_returnConfigEntry.md) instead of [BIS_fnc_getCfgData](../functions/BIS_fnc_getCfgData.md).

```sqf
[(configFile >> "CannonFire" >> "LightExp"),"lifeTime",0] call BIS_fnc_returnConfigEntry; // 0.5
```

---

**demellion** — 2018-01-12

There is special behaviour if you try to read a description.ext config entry [Array](../topics/Array.md) that contains a [Boolean](../topics/Boolean.md).

Getting array in **MP** will result in [Number](../topics/Number.md), while **SP** will return [String](../topics/String.md).

```sqf
// SP with false in array
getArray (missionConfigFile >> "someClass" >> "someArray") // -> "false"

// MP with false in array
getArray (missionConfigFile >> "someClass" >> "someArray") // -> 0
```

<sub>Source: [BI Community Wiki — getArray](https://community.bistudio.com/wiki/getArray) (revision 377159).</sub>