| 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. |