am_map_find_first_value()

Returns the first value associated with the specified key in the specified map.

Syntax

#include "am_map.h"
AM_EXPORT const char *
am_map_find_first_value(am_map_t map, const char *key);

Parameters

This function takes the following parameters:

map

The handle for the map object to be examined.

key

The key for the entry to look up.

Returns

This function returns const char * with one of the following values:

NULL

If the specified key could not be found in the map or the specified key had no associated values.

value

Otherwise, the first value associated with the key.

Details

This function takes a key and returns the first value associated with the key.

Memory Concerns: Caller must not modify or free the return value.