src/cx/map.h

changeset 1114
ad5eeb256242
parent 1111
78eeeb950883
child 1115
6db21dee4929
equal deleted inserted replaced
1113:dce04550fbef 1114:ad5eeb256242
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.

mercurial