am_map_find_first_value()

Returns the first value associated with the specified key in the specified map object.

Details

am_map_find_first_value() takes a key and returns the first value associated with that key.

Syntax

#include "am_map.h"
AM_EXPORT const char *
am_map_find_first_value(am_map_t map, 
                        const char *key);

Parameters

This function takes the following parameters:

map

The specified map object.

key

Pointer to a key.

Returns

This function returns one of the following values:

char *

Returns the first value associated with the specified key.

---

Note –

Caller must not modify or free the return value.

---

NULL

If the specified key could not be found in the map or had no associated values.