---
name: "createHashMapFromArray"
type: command
status: ok
groups: ["HashMap", "Arrays"]
arma3_since: "2.02"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/createHashMapFromArray
revid: 377214
updated: 2026-01-02T00:12:06Z
---

# createHashMapFromArray

*Command · HashMap, Arrays · Arma 3 v2.02*

## Description

Creates a new [HashMap](../topics/HashMap.md) and initializes it from a key-value pair array

## Syntax

### Syntax 1

```sqf
createHashMapFromArray [[key1, value1], [key2, value2], ...]
```

**Parameters:**

- `keyN`: [HashMapKey](../topics/HashMapKey.md)
- `valueN`: [Anything](../topics/Anything.md)

**Returns:** [HashMap](../topics/HashMap.md)

### Syntax 2

*since arma3 2.04*

```sqf
keys createHashMapFromArray values
```

**Parameters:**

- `keys`: [Array](../topics/Array.md) of [HashMapKey](../topics/HashMapKey.md)s
- `values`: [Array](../topics/Array.md) of [Anything](../topics/Anything.md)

  > [!NOTE]
  > Size of *keys* and size of *values* arrays do not need to be equal. Missing values will be filled with [nil](../commands/nil.md).

**Returns:** [HashMap](../topics/HashMap.md)

## Examples

### Example 1

```sqf
createHashMapFromArray [["a", 1], ["b", 2], ["c", 3]];
```

### Example 2

```sqf
[1, 2, 3, 4] createHashMapFromArray []; // returns [[1, <null>], [2, <null>], [4, <null>], [3, <null>]]
```

### Example 3

```sqf
[1, 2, 3] createHashMapFromArray ["one", "two", "three", "four"]; // returns [[1, "one"], [2, "two"], [3, "three"]]
```

## See also

[createHashMap](../commands/createHashMap.md)

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