void* pblMapGet

( PblMap* map, void* key, size_t keyLength,
  size_t* valueLengthPtr )

Returns the value to which the specified key is mapped, or null if this map contains no mapping for the key.

Documentation

Returns the value to which the specified key is mapped, or null if this map contains no mapping for the key.

More formally, if this map contains a mapping from a key k to a value v such that (key==null ? k==null : memcmp( key, k, keyLength ) == 0, then this method returns v; otherwise it returns null. (There can be at most one such mapping.)

For hash maps this method has a time complexity of O(1). For tree maps this method has a time complexity of O(Log N).

Parameters:

map - The map to check
key - Key whose associated value is to be returned
keyLength - Length of the key
valueLengthPtr - Out: Length of the value returned

Returns:

void * retptr != NULL: The associated value.
void * retptr == NULL: There is no associated value.

Alphabetic index