am_map_destroy()

Destroys the specified map object.

Syntax

#include "am_map.h"
AM_EXPORT void
am_map_destroy(am_map_t map);

Parameters

This function takes the following parameter:

map

The specified map object. It may be NULL.

---

Caution –

Be sure not to pass map as a valid am_map structure as the reference will be lost.

---

Returns

This function does not return a value.

Memory Concerns

The pointer to the specified map object can not be freed before calling am_map_destroy(). This includes erroneously calling the system free(void *) function.