Returns an iterator object that can be used to enumerate all of the entries in the specified map.
#include "am_map.h" AM_EXPORT am_status_t am_map_get_entries(am_map_t map, am_map_entry_iter_t *entry_iter_ptr);
This function takes the following parameters:
The handle for the map object to be examined.
Pointer to where the handle for the new entry iterator object should be stored.
This function returns am_status_t with one of the following values:
If no error was detected.
If unable to allocate memory for the entry iterator object.
If the entry_iter_ptr argument is NULL.
If the specified map contains no keys.
This function extracts an iterator pointer that can be used to iterate over the key value pairs stored in this table.
Memory Concerns: The iterator pointer passed in must not have non-destroyed iterators assigned to them. The caller, in future must call am_map_entry_iter_destroy to destroy the iterator instance.
If the entry_iter_ptr argument is non-NULL, then the location that it refers to will be set to NULL if an error is returned.