Returns

This function returns const char * with one of the following values:

Value

If the operation is successful, returns the first associated value of this iterator. The order of insertion into the map does not guarantee the value returned.

NULL

If the specified iterator is NULL or does not reference a valid entry or the entry does not have any associated values.