Returns a value iterator that can sequence through all values associated with the specified key in the specified map object.
#include "am_map.h" AM_EXPORT am_status_t am_map_find(am_map_t map, const char *key, am_map_value_iter_t *value_iter_ptr);
This function takes the following parameters:
The specified map object.
Pointer to a key.
Pointer specifying the location of the returned value iterator.
If value_iter_ptr is not NULL, the location that it references will be set to NULL if an error is returned.
This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If no error was detected.
If unable to allocate memory for the key iterator.
If the value_iter_ptr argument is NULL.
If the specified key is not found in the map.
After using value_iter_ptr, the caller must call am_map_value_iter_destroy().