Returns a map iterator on a function pointer for the specified map object.
am_map_for_each() will iterate over the list of key/value pairs and call each one. For every key in the map, a function can be invoked via the function pointer.
#include "am_map.h" AM_EXPORT am_status_t am_map_for_each(am_map_t, am_status_t (*func)(const char *key, const char *value, void **args), void **args);
This function takes the following parameters:
The specified map object.
Pointer to a key in an entry.
Pointer to application-defined parameters.
This function returns one of the following values:
If the function returns any code other than AM_SUCCESS, the iteration will terminate and the same status code will be returned to the user.
If the parameters are invalid.