ArmaRAMDb |

Loading...
Searching...
No Matches
hashGetId

## autotoc_md246

title: ArmaRAMDb - Hash Get ID icon: mdi:file-text-outline

## excerpt: 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 ID | Hash Get | Hash Get All | Hash Get All ID | Hash Get ID | Hash Remove | Hash Remove ID | Hash Set | Hash Set Bulk | Hash Set ID | Hash Set ID Bulk