Hash Operations

Important Payload Limit

Keep payloads under 20,480 bytes. This is the maximum size the engine can send or receive at one time. If you expect a response larger than 20,480 bytes, provide a callback function so the mod can use its internal fetch/chunking flow and deliver the reconstructed data to your callback.

This section contains documentation for the hash operations of ArmaDragonflyClient that allow for working with hash tables (key-value pairs within a namespace).

Available Functions

  • hashGet - Get a field from a hash
  • hashGetAll - Get all fields from a hash
  • hashGetAllId - Get all fields from a hash for a specific ID
  • hashGetId - Get a field from a hash for a specific ID
  • hashSet - Set a field in a hash
  • hashSetBulk - Set multiple fields in a hash in one operation
  • hashSetId - Set a field in a hash for a specific ID
  • hashSetIdBulk - Set multiple fields in a hash for a specific ID in one operation

Example Usage

// Context mode examples
["myField", [myValue]] call dragonfly_db_fnc_hashSet;
["myField", "myFunction"] call dragonfly_db_fnc_hashGet;
["myFunction"] call dragonfly_db_fnc_hashGetAll;

// Set multiple hash fields in one operation
[[
    "loadout", [getUnitLoadout player],
    "position", [getPosASL player],
    "direction", [getDir player]
]] call dragonfly_db_fnc_hashSetBulk;

// ID-specific examples
["myHash", "myField", [myValue]] call dragonfly_db_fnc_hashSetId;
["myHash", "myField", "myFunction"] call dragonfly_db_fnc_hashGetId;
["myHash"] call dragonfly_db_fnc_hashGetAllId;