mg_map_insert

Inserts the given key-value pair into the map.

A check is performed to see if the given key is unique in the map which means that a number of key comparisons equal to the current number of elements in the map is made.

If key length is greater that uint.max, or the key already exists in map, or the map's capacity is exhausted, the insertion will fail. If insertion fails, the map doesn't take ownership of value.

If the insertion is successful, a new mg_string is constructed for the storage of the key and the map takes ownership of value.

extern (C) @safe @nogc pure nothrow
mg_map_insert
(,
const char* key_str
,)

Parameters

key_str char*

A null-terminated string to be used as key.

value mg_value*

Value to be inserted.

Return: The function returns non-zero value if insertion failed, zero otherwise.

Meta