ramdb/docs/hash/hashGetId.md

title, icon, excerpt

title	icon	excerpt
ArmaRAMDb - Hash Get ID	mdi:file-text-outline	Get the value associated with field in hash stored at key from RAMDb.

ramdb_db_fnc_hashGetId

Description

Retrieves the value of a specific field from a hash table identified by its key. This function allows targeted access to individual fields within a specific hash table, making it ideal for accessing particular attributes of player or entity data. The retrieved data is returned through a callback function.

Syntax

[_key, _keyField, _function, _call, _netId] call ramdb_db_fnc_hashGetId

Parameters

Parameter	Type	Description	Default
_key	String	Identifier of the hash table	""
_keyField	String	Name of the field in the hash to retrieve	""
_function	String	Name of the function to receive the retrieved data	""
_call	Boolean	Whether to call the function directly (true) or spawn (false)	false
_netId	String	(Optional) NetID of the player to receive the data	""

Return Value

None. The retrieved data is passed to the specified callback function asynchronously.

Examples

Retrieve a player's loadout field:

[getPlayerUID player, "loadout", "ramdb_db_fnc_test"] call ramdb_db_fnc_hashGetId;

Retrieve a specific vehicle property with synchronous callback:

["vehicle_123", "fuel", "ramdb_db_fnc_processFuelData", true] call ramdb_db_fnc_hashGetId;

Retrieve data and send it to a specific client:

[getPlayerUID player, "stats", "ramdb_db_fnc_test", false, netId player] remoteExecCall ["ramdb_db_fnc_hashGetId", 2, false];

Notes

• Retrieves a single field value from a specific hash table
• All three primary parameters (key, keyField, and function) are required and validated
• The data is retrieved asynchronously through the extension's callback system
• When a netId is provided, the data is sent to that specific client
• The _call parameter determines whether the function is called directly (synchronous) or spawned (asynchronous)
• This function targets both a specific hash table (_key) and a specific field (_keyField)
• More efficient than retrieving all hash fields when only one is needed
• Player UIDs are commonly used as keys to store player-specific data
• All operations are logged for debugging purposes

Related Functions

• ramdb_db_fnc_hashGet: Retrieves a field value from the global hash table
• ramdb_db_fnc_hashGetAllId: Retrieves all fields from a specific hash table
• ramdb_db_fnc_hashGetAll: Retrieves all fields from the global hash table
• ramdb_db_fnc_hashSetId: Sets a field value in a specific hash table
• ramdb_db_fnc_scheduler: Processes the callback from the database extension

Links

Hash Delete | Hash Delete Field | Hash Delete ID | Hash Get | Hash Get All | Hash Get All ID | Hash Get ID | Hash Set | Hash Set Bulk | Hash Set ID | Hash Set ID Bulk