Zen API

- Home
- Topics
- Types
- Files

All Classes Files Functions Variables Typedefs Friends Macros Modules Pages

#define kMap_ReplaceT | ( |  | kMap_map,
|  |  | KPtr_key,
|  |  | VPtr_value
| ) |  |
| related

Adds or replaces a key-value pair.

For object-based keys or values, the old objects are not automatically disposed. In this case, consider using kMap_Remove to first remove and dispose the existing item, then kMap_Add to add the new item.

A debug assertion will be raised if the size of the specified key or value type is not equal to the size of the collection key or value type, respectively.

Parameters

  kMap_map | Map object.
  KPtr_key | Strongly-typed pointer to key.
  VPtr_value | Strongly-typed pointer to value.

Returns
  Operation status.