492 |
492 |
493 /** |
493 /** |
494 * Puts a key/value-pair into the map. |
494 * Puts a key/value-pair into the map. |
495 * |
495 * |
496 * A possible existing value will be overwritten. |
496 * A possible existing value will be overwritten. |
|
497 * If destructor functions are specified, they are called for |
|
498 * the overwritten element. |
497 * |
499 * |
498 * If this map is storing pointers, the @p value pointer is written |
500 * If this map is storing pointers, the @p value pointer is written |
499 * to the map. Otherwise, the memory is copied from @p value with |
501 * to the map. Otherwise, the memory is copied from @p value with |
500 * memcpy(). |
502 * memcpy(). |
501 * |
503 * |
703 |
705 |
704 /** |
706 /** |
705 * Removes a key/value-pair from the map by using the key. |
707 * Removes a key/value-pair from the map by using the key. |
706 * |
708 * |
707 * This function will copy the contents of the removed element |
709 * This function will copy the contents of the removed element |
708 * to the target buffer must be guaranteed to be large enough |
710 * to the target buffer, which must be guaranteed to be large enough |
709 * to hold the element (the map's element size). |
711 * to hold the element (the map's element size). |
710 * The destructor functions, if any, will @em not be called. |
712 * The destructor functions, if any, will @em not be called. |
711 * |
713 * |
712 * If this map is storing pointers, the element is the pointer itself |
714 * If this map is storing pointers, the element is the pointer itself |
713 * and not the object it points to. |
715 * and not the object it points to. |