am_map_create()

Creates a new, empty map object.

Syntax

#include "am_map.h"
AM_EXPORT am_status_t
am_map_create(am_map_t *map_ptr);

Parameters

This function takes the following parameters:

map_ptr

Pointer to where the handle for the new map object should be stored.

Returns

This function returns am_status_t with one of the following values:

AM_SUCCESS

If a map was successfully created.

AM_NO_MEMORY

If unable to allocate memory for the map object.

AM_INVALID_ARGUMENT

If the map_ptr parameter is NULL.