autotoc_md247
title: ArmaDragonflyClient - Hash Set ID icon: mdi:file-text-outline
excerpt: Set the specified field to the respective value in the hash stored at key from DragonflyClient.
dragonfly_db_fnc_hashSetId
Description
Sets the value of a specified field in a specific hash table identified by its key. This function allows storing various data types (arrays, strings, numbers, or booleans) in a targeted hash table, making it ideal for player-specific or entity-specific data storage. It provides a way to organize related data under a common identifier.
Syntax
[_key, _keyField, _data] call dragonfly_db_fnc_hashSetId
Parameters
Parameter | Type | Description | Default |
_key | String | Identifier of the hash table | "" |
_keyField | String | Name of the field in the hash to set | "" |
_data | Array, String, Number, or Boolean | The value to store in the hash field | [] |
Return Value
None. The operation runs synchronously to store the data.
Examples
Store a player's loadout under their UID:
[getPlayerUID player, "loadout", [getUnitLoadout player]] call dragonfly_db_fnc_hashSetId;
Store vehicle data:
["vehicle_123", "status", [true, 100, 75, "active"]] call dragonfly_db_fnc_hashSetId;
Store player data from a client:
[getPlayerUID player, "stats", [rank player, score player, name player]] remoteExecCall ["dragonfly_db_fnc_hashSetId", 2, false];
Notes
- Stores a single field-value pair in a specific hash table identified by
_key
- All three parameters (key, keyField, and data) are required and validated
- If the hash table doesn't exist, it will be created automatically
- If the field already exists in the hash table, its value will be overwritten
- Supports various data types: arrays, strings, numbers, and booleans
- Player UIDs are commonly used as keys to store player-specific data
- Complex data structures should be serialized into arrays
- The operation is executed immediately and synchronously
- All operations are logged for debugging purposes
Related Functions
dragonfly_db_fnc_hashSet
: Sets a field value in the global hash table
dragonfly_db_fnc_hashGetId
: Retrieves a field value from a specific hash table
dragonfly_db_fnc_hashGetAllId
: Retrieves all fields from a specific hash table
dragonfly_db_fnc_hashSetIdBulk
: Sets multiple field-value pairs in multiple hash tables
Links
Hash Get | Hash Get All | Hash Get All ID | Hash Get ID | Hash Set | Hash Set Bulk | Hash Set ID | Hash Set ID Bulk