ucx: comparison src/cx/map.h

-:2872f287fadc
+:db5e355e5349
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */
 /**
-* \file map.h
+* @file map.h
-* \brief Interface for map implementations.
+* @brief Interface for map implementations.
-* \author Mike Becker
+* @author Mike Becker
-* \author Olaf Wintermann
+* @author Olaf Wintermann
-* \copyright 2-Clause BSD License
+* @copyright 2-Clause BSD License
 */
 #ifndef UCX_MAP_H
 #define UCX_MAP_H
 */
 struct cx_map_class_s {
 /**
 * Deallocates the entire memory.
 */
-cx_attr_nonnull
 void (*deallocate)(struct cx_map_s *map);
 /**
 * Removes all elements.
 */
-cx_attr_nonnull
 void (*clear)(struct cx_map_s *map);
 /**
 * Add or overwrite an element.
 */
-cx_attr_nonnull
 int (*put)(
 CxMap *map,
 CxHashKey key,
 void *value
 );
 /**
 * Returns an element.
 */
-cx_attr_nonnull
-cx_attr_nodiscard
 void *(*get)(
 const CxMap *map,
 CxHashKey key
 );
 /**
 * Removes an element.
 *
-* Implementations SHALL check if \p targetbuf is set and copy the elements
+* Implementations SHALL check if @p targetbuf is set and copy the elements
 * to the buffer without invoking any destructor.
-* When \p targetbuf is not set, the destructors SHALL be invoked.
+* When @p targetbuf is not set, the destructors SHALL be invoked.
 *
-* The function SHALL return zero when the \p key was found and
+* The function SHALL return zero when the @p key was found and
 * non-zero, otherwise.
 */
-cx_attr_nonnull_arg(1)
-cx_attr_access_w(3)
 int (*remove)(
 CxMap *map,
 CxHashKey key,
 void *targetbuf
 );
 /**
 * Creates an iterator for this map.
 */
-cx_attr_nonnull
-cx_attr_nodiscard
 CxIterator (*iterator)(const CxMap *map, enum cx_map_iterator_type type);
 };
 /**
 * A map entry.
 /**
 * A shared instance of an empty map.
 *
 * Writing to that map is not allowed.
+*
+* You can use this is a placeholder for initializing CxMap pointers
+* for which you do not want to reserve memory right from the beginning.
 */
 extern CxMap *const cxEmptyMap;
 /**
 * Advises the map to store copies of the objects (default mode of operation).
 }
 /**
 * Deallocates the memory of the specified map.
 *
+* Also calls the content destructor functions for each element, if specified.
+*
 * @param map the map to be freed
 */
 static inline void cxMapFree(CxMap *map) {
 if (map == NULL) return;
 map->cl->deallocate(map);
 /**
 * Clears a map by removing all elements.
 *
+* Also calls the content destructor functions for each element, if specified.
+*
 * @param map the map to be cleared
 */
 cx_attr_nonnull
 static inline void cxMapClear(CxMap *map) {
 map->cl->clear(map);
 cx_attr_nonnull
 static inline size_t cxMapSize(const CxMap *map) {
 return map->collection.size;
 }
-// TODO: set-like map operations (union, intersect, difference)
 /**
 * Creates a value iterator for a map.
 *
-* \note An iterator iterates over all elements successively. Therefore, the order
+* @note An iterator iterates over all elements successively. Therefore, the order
 * highly depends on the map implementation and may change arbitrarily when the contents change.
 *
 * @param map the map to create the iterator for
 * @return an iterator for the currently stored values
 */
 /**
 * Creates a key iterator for a map.
 *
 * The elements of the iterator are keys of type CxHashKey.
 *
-* \note An iterator iterates over all elements successively. Therefore, the order
+* @note An iterator iterates over all elements successively. Therefore, the order
 * highly depends on the map implementation and may change arbitrarily when the contents change.
 *
 * @param map the map to create the iterator for
 * @return an iterator for the currently stored keys
 */
 /**
 * Creates an iterator for a map.
 *
 * The elements of the iterator are key/value pairs of type CxMapEntry.
 *
-* \note An iterator iterates over all elements successively. Therefore, the order
+* @note An iterator iterates over all elements successively. Therefore, the order
 * highly depends on the map implementation and may change arbitrarily when the contents change.
 *
 * @param map the map to create the iterator for
 * @return an iterator for the currently stored entries
 * @see cxMapIteratorKeys()
 /**
 * Creates a mutating iterator over the values of a map.
 *
-* \note An iterator iterates over all elements successively. Therefore, the order
+* @note An iterator iterates over all elements successively. Therefore, the order
 * highly depends on the map implementation and may change arbitrarily when the contents change.
 *
 * @param map the map to create the iterator for
 * @return an iterator for the currently stored values
 */
 /**
 * Creates a mutating iterator over the keys of a map.
 *
 * The elements of the iterator are keys of type CxHashKey.
 *
-* \note An iterator iterates over all elements successively. Therefore, the order
+* @note An iterator iterates over all elements successively. Therefore, the order
 * highly depends on the map implementation and may change arbitrarily when the contents change.
 *
 * @param map the map to create the iterator for
 * @return an iterator for the currently stored keys
 */
 /**
 * Creates a mutating iterator for a map.
 *
 * The elements of the iterator are key/value pairs of type CxMapEntry.
 *
-* \note An iterator iterates over all elements successively. Therefore, the order
+* @note An iterator iterates over all elements successively. Therefore, the order
 * highly depends on the map implementation and may change arbitrarily when the contents change.
 *
 * @param map the map to create the iterator for
 * @return an iterator for the currently stored entries
 * @see cxMapMutIteratorKeys()
 cx_attr_nodiscard
 CxIterator cxMapMutIterator(CxMap *map);
 #ifdef __cplusplus
 } // end the extern "C" block here, because we want to start overloading
-/**
-* Puts a key/value-pair into the map.
-*
-* @param map the map
-* @param key the key
-* @param value the value
-* @return 0 on success, non-zero value on failure
-*/
 cx_attr_nonnull
 static inline int cxMapPut(
 CxMap *map,
 CxHashKey const &key,
 void *value
 ) {
 return map->cl->put(map, key, value);
 }
-/**
-* Puts a key/value-pair into the map.
-*
-* @param map the map
-* @param key the key
-* @param value the value
-* @return 0 on success, non-zero value on failure
-*/
 cx_attr_nonnull
 static inline int cxMapPut(
 CxMap *map,
 cxstring const &key,
 void *value
 ) {
 return map->cl->put(map, cx_hash_key_cxstr(key), value);
 }
-/**
-* Puts a key/value-pair into the map.
-*
-* @param map the map
-* @param key the key
-* @param value the value
-* @return 0 on success, non-zero value on failure
-*/
 cx_attr_nonnull
 static inline int cxMapPut(
 CxMap *map,
 cxmutstr const &key,
 void *value
 ) {
 return map->cl->put(map, cx_hash_key_cxstr(key), value);
 }
-/**
-* Puts a key/value-pair into the map.
-*
-* @param map the map
-* @param key the key
-* @param value the value
-* @return 0 on success, non-zero value on failure
-*/
 cx_attr_nonnull
 cx_attr_cstr_arg(2)
 static inline int cxMapPut(
 CxMap *map,
 const char *key,
 void *value
 ) {
 return map->cl->put(map, cx_hash_key_str(key), value);
 }
-/**
-* Retrieves a value by using a key.
-*
-* @param map the map
-* @param key the key
-* @return the value
-*/
 cx_attr_nonnull
 cx_attr_nodiscard
 static inline void *cxMapGet(
 const CxMap *map,
 CxHashKey const &key
 ) {
 return map->cl->get(map, key);
 }
-/**
-* Retrieves a value by using a key.
-*
-* @param map the map
-* @param key the key
-* @return the value
-*/
 cx_attr_nonnull
 cx_attr_nodiscard
 static inline void *cxMapGet(
 const CxMap *map,
 cxstring const &key
 ) {
 return map->cl->get(map, cx_hash_key_cxstr(key));
 }
-/**
-* Retrieves a value by using a key.
-*
-* @param map the map
-* @param key the key
-* @return the value
-*/
 cx_attr_nonnull
 cx_attr_nodiscard
 static inline void *cxMapGet(
 const CxMap *map,
 cxmutstr const &key
 ) {
 return map->cl->get(map, cx_hash_key_cxstr(key));
 }
-/**
-* Retrieves a value by using a key.
-*
-* @param map the map
-* @param key the key
-* @return the value
-*/
 cx_attr_nonnull
 cx_attr_nodiscard
 cx_attr_cstr_arg(2)
 static inline void *cxMapGet(
 const CxMap *map,
 const char *key
 ) {
 return map->cl->get(map, cx_hash_key_str(key));
 }
-/**
-* Removes a key/value-pair from the map by using the key.
-*
-* Always invokes the destructors functions, if any, on the removed element.
-*
-* @param map the map
-* @param key the key
-* @return zero on success, non-zero if the key was not found
-*
-* @see cxMapRemoveAndGet()
-*/
 cx_attr_nonnull
 static inline int cxMapRemove(
 CxMap *map,
 CxHashKey const &key
 ) {
 return map->cl->remove(map, key, nullptr);
 }
-/**
-* Removes a key/value-pair from the map by using the key.
-*
-* Always invokes the destructors functions, if any, on the removed element.
-*
-* @param map the map
-* @param key the key
-* @return zero on success, non-zero if the key was not found
-*
-* @see cxMapRemoveAndGet()
-*/
 cx_attr_nonnull
 static inline int cxMapRemove(
 CxMap *map,
 cxstring const &key
 ) {
 return map->cl->remove(map, cx_hash_key_cxstr(key), nullptr);
 }
-/**
-* Removes a key/value-pair from the map by using the key.
-*
-* Always invokes the destructors functions, if any, on the removed element.
-*
-* @param map the map
-* @param key the key
-* @return zero on success, non-zero if the key was not found
-*
-* @see cxMapRemoveAndGet()
-*/
 cx_attr_nonnull
 static inline int cxMapRemove(
 CxMap *map,
 cxmutstr const &key
 ) {
 return map->cl->remove(map, cx_hash_key_cxstr(key), nullptr);
 }
-/**
-* Removes a key/value-pair from the map by using the key.
-*
-* Always invokes the destructors functions, if any, on the removed element.
-*
-* @param map the map
-* @param key the key
-* @return zero on success, non-zero if the key was not found
-*
-* @see cxMapRemoveAndGet()
-*/
 cx_attr_nonnull
 cx_attr_cstr_arg(2)
 static inline int cxMapRemove(
 CxMap *map,
 const char *key
 ) {
 return map->cl->remove(map, cx_hash_key_str(key), nullptr);
 }
-/**
-* Removes a key/value-pair from the map by using the key.
-*
-* This function will copy the contents to the target buffer
-* which must be guaranteed to be large enough to hold the element.
-* The destructor functions, if any, will \em not be called.
-*
-* If this map is storing pointers, the element is the pointer itself
-* and not the object it points to.
-*
-* @param map the map
-* @param key the key
-* @param targetbuf the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
-*
-* @see cxMapStorePointers()
-* @see cxMapRemove()
-*/
 cx_attr_nonnull
 cx_attr_access_w(3)
 static inline int cxMapRemoveAndGet(
 CxMap *map,
 CxHashKey key,
 void *targetbuf
 ) {
 return map->cl->remove(map, key, targetbuf);
 }
-/**
-* Removes a key/value-pair from the map by using the key.
-*
-* This function will copy the contents to the target buffer
-* which must be guaranteed to be large enough to hold the element.
-* The destructor functions, if any, will \em not be called.
-*
-* If this map is storing pointers, the element is the pointer itself
-* and not the object it points to.
-*
-* @param map the map
-* @param key the key
-* @param targetbuf the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
-*
-* @see cxMapStorePointers()
-* @see cxMapRemove()
-*/
 cx_attr_nonnull
 cx_attr_access_w(3)
 static inline int cxMapRemoveAndGet(
 CxMap *map,
 cxstring key,
 void *targetbuf
 ) {
 return map->cl->remove(map, cx_hash_key_cxstr(key), targetbuf);
 }
-/**
-* Removes a key/value-pair from the map by using the key.
-*
-* This function will copy the contents to the target buffer
-* which must be guaranteed to be large enough to hold the element.
-* The destructor functions, if any, will \em not be called.
-*
-* If this map is storing pointers, the element is the pointer itself
-* and not the object it points to.
-*
-* @param map the map
-* @param key the key
-* @param targetbuf the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
-*
-* @see cxMapStorePointers()
-* @see cxMapRemove()
-*/
 cx_attr_nonnull
 cx_attr_access_w(3)
 static inline int cxMapRemoveAndGet(
 CxMap *map,
 cxmutstr key,
 void *targetbuf
 ) {
 return map->cl->remove(map, cx_hash_key_cxstr(key), targetbuf);
 }
-/**
-* Removes a key/value-pair from the map by using the key.
-*
-* This function will copy the contents to the target buffer
-* which must be guaranteed to be large enough to hold the element.
-* The destructor functions, if any, will \em not be called.
-*
-* If this map is storing pointers, the element is the pointer itself
-* and not the object it points to.
-*
-* @param map the map
-* @param key the key
-* @param targetbuf the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
-*
-* @see cxMapStorePointers()
-* @see cxMapRemove()
-*/
 cx_attr_nonnull
 cx_attr_access_w(3)
 cx_attr_cstr_arg(2)
 static inline int cxMapRemoveAndGet(
 CxMap *map,
 }
 #else // __cplusplus
 /**
-* Puts a key/value-pair into the map.
+* @copydoc cxMapPut()
-*
-* @param map the map
-* @param key the key
-* @param value the value
-* @return 0 on success, non-zero value on failure
 */
 cx_attr_nonnull
 static inline int cx_map_put(
 CxMap *map,
 CxHashKey key,
 ) {
 return map->cl->put(map, key, value);
 }
 /**
-* Puts a key/value-pair into the map.
+* @copydoc cxMapPut()
-*
-* @param map the map
-* @param key the key
-* @param value the value
-* @return 0 on success, non-zero value on failure
 */
 cx_attr_nonnull
 static inline int cx_map_put_cxstr(
 CxMap *map,
 cxstring key,
 ) {
 return map->cl->put(map, cx_hash_key_cxstr(key), value);
 }
 /**
-* Puts a key/value-pair into the map.
+* @copydoc cxMapPut()
-*
-* @param map the map
-* @param key the key
-* @param value the value
-* @return 0 on success, non-zero value on failure
 */
 cx_attr_nonnull
 static inline int cx_map_put_mustr(
 CxMap *map,
 cxmutstr key,
 ) {
 return map->cl->put(map, cx_hash_key_cxstr(key), value);
 }
 /**
-* Puts a key/value-pair into the map.
+* @copydoc cxMapPut()
-*
-* @param map the map
-* @param key the key
-* @param value the value
-* @return 0 on success, non-zero value on failure
 */
 cx_attr_nonnull
 cx_attr_cstr_arg(2)
 static inline int cx_map_put_str(
 CxMap *map,
 }
 /**
 * Puts a key/value-pair into the map.
 *
-* @param map the map
+* A possible existing value will be overwritten.
-* @param key the key
+*
-* @param value the value
+* If this map is storing pointers, the @p value pointer is written
-* @return 0 on success, non-zero value on failure
+* to the map. Otherwise, the memory is copied from @p value with
+* memcpy().
+*
+* The @p key is always copied.
+*
+* @param map (@c CxMap*) the map
+* @param key (@c CxHashKey, @c char*, @c cxstring, or @c cxmutstr) the key
+* @param value (@c void*) the value
+* @retval zero success
+* @retval non-zero value on memory allocation failure
 */
 #define cxMapPut(map, key, value) _Generic((key), \
 CxHashKey: cx_map_put,                        \
 cxstring: cx_map_put_cxstr,                   \
 cxmutstr: cx_map_put_mustr,                   \
 char*: cx_map_put_str,                        \
 const char*: cx_map_put_str)                  \
 (map, key, value)
 /**
-* Retrieves a value by using a key.
+* @copydoc cxMapGet()
-*
-* @param map the map
-* @param key the key
-* @return the value
 */
 cx_attr_nonnull
 cx_attr_nodiscard
 static inline void *cx_map_get(
 const CxMap *map,
 ) {
 return map->cl->get(map, key);
 }
 /**
-* Retrieves a value by using a key.
+* @copydoc cxMapGet()
-*
-* @param map the map
-* @param key the key
-* @return the value
 */
 cx_attr_nonnull
 cx_attr_nodiscard
 static inline void *cx_map_get_cxstr(
 const CxMap *map,
 ) {
 return map->cl->get(map, cx_hash_key_cxstr(key));
 }
 /**
-* Retrieves a value by using a key.
+* @copydoc cxMapGet()
-*
-* @param map the map
-* @param key the key
-* @return the value
 */
 cx_attr_nonnull
 cx_attr_nodiscard
 static inline void *cx_map_get_mustr(
 const CxMap *map,
 ) {
 return map->cl->get(map, cx_hash_key_cxstr(key));
 }
 /**
-* Retrieves a value by using a key.
+* @copydoc cxMapGet()
-*
-* @param map the map
-* @param key the key
-* @return the value
 */
 cx_attr_nonnull
 cx_attr_nodiscard
 cx_attr_cstr_arg(2)
 static inline void *cx_map_get_str(
 }
 /**
 * Retrieves a value by using a key.
 *
-* @param map the map
+* If this map is storing pointers, the stored pointer is returned.
-* @param key the key
+* Otherwise, a pointer to the element within the map's memory
-* @return the value
+* is returned (which is valid as long as the element stays in the map).
+*
+* @param map (@c CxMap*) the map
+* @param key (@c CxHashKey, @c char*, @c cxstring, or @c cxmutstr) the key
+* @return (@c void*) the value
 */
 #define cxMapGet(map, key) _Generic((key), \
 CxHashKey: cx_map_get,                 \
 cxstring: cx_map_get_cxstr,            \
 cxmutstr: cx_map_get_mustr,            \
 char*: cx_map_get_str,                 \
 const char*: cx_map_get_str)           \
 (map, key)
 /**
-* Removes a key/value-pair from the map by using the key.
+* @copydoc cxMapRemove()
-*
-* Always invokes the destructors functions, if any, on the removed element.
-*
-* @param map the map
-* @param key the key
-* @return zero on success, non-zero if the key was not found
 */
 cx_attr_nonnull
 static inline int cx_map_remove(
 CxMap *map,
 CxHashKey key
 ) {
 return map->cl->remove(map, key, NULL);
 }
 /**
-* Removes a key/value-pair from the map by using the key.
+* @copydoc cxMapRemove()
-*
-* Always invokes the destructors functions, if any, on the removed element.
-*
-* @param map the map
-* @param key the key
-* @return zero on success, non-zero if the key was not found
 */
 cx_attr_nonnull
 static inline int cx_map_remove_cxstr(
 CxMap *map,
 cxstring key
 ) {
 return map->cl->remove(map, cx_hash_key_cxstr(key), NULL);
 }
 /**
-* Removes a key/value-pair from the map by using the key.
+* @copydoc cxMapRemove()
-*
-* Always invokes the destructors functions, if any, on the removed element.
-*
-* @param map the map
-* @param key the key
-* @return zero on success, non-zero if the key was not found
 */
 cx_attr_nonnull
 static inline int cx_map_remove_mustr(
 CxMap *map,
 cxmutstr key
 ) {
 return map->cl->remove(map, cx_hash_key_cxstr(key), NULL);
 }
 /**
-* Removes a key/value-pair from the map by using the key.
+* @copydoc cxMapRemove()
-*
-* Always invokes the destructors functions, if any, on the removed element.
-*
-* @param map the map
-* @param key the key
-* @return zero on success, non-zero if the key was not found
 */
 cx_attr_nonnull
 cx_attr_cstr_arg(2)
 static inline int cx_map_remove_str(
 CxMap *map,
 /**
 * Removes a key/value-pair from the map by using the key.
 *
 * Always invokes the destructors functions, if any, on the removed element.
 *
-* @param map the map
+* @param map (@c CxMap*) the map
-* @param key the key
+* @param key (@c CxHashKey, @c char*, @c cxstring, or @c cxmutstr) the key
-* @return zero on success, non-zero if the key was not found
+* @retval zero success
+* @retval non-zero the key was not found
 *
 * @see cxMapRemoveAndGet()
 */
 #define cxMapRemove(map, key) _Generic((key), \
 CxHashKey: cx_map_remove,                 \
 char*: cx_map_remove_str,                 \
 const char*: cx_map_remove_str)           \
 (map, key)
 /**
-* Removes a key/value-pair from the map by using the key.
+* @copydoc cxMapRemoveAndGet()
-*
-* This function will copy the contents to the target buffer
-* which must be guaranteed to be large enough to hold the element.
-* The destructor functions, if any, will \em not be called.
-*
-* If this map is storing pointers, the element is the pointer itself
-* and not the object it points to.
-*
-* @param map the map
-* @param key the key
-* @param targetbuf the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
 */
 cx_attr_nonnull
 cx_attr_access_w(3)
 static inline int cx_map_remove_and_get(
 CxMap *map,
 ) {
 return map->cl->remove(map, key, targetbuf);
 }
 /**
-* Removes a key/value-pair from the map by using the key.
+* @copydoc cxMapRemoveAndGet()
-*
-* This function will copy the contents to the target buffer
-* which must be guaranteed to be large enough to hold the element.
-* The destructor functions, if any, will \em not be called.
-*
-* If this map is storing pointers, the element is the pointer itself
-* and not the object it points to.
-*
-* @param map the map
-* @param key the key
-* @param targetbuf the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
 */
 cx_attr_nonnull
 cx_attr_access_w(3)
 static inline int cx_map_remove_and_get_cxstr(
 CxMap *map,
 ) {
 return map->cl->remove(map, cx_hash_key_cxstr(key), targetbuf);
 }
 /**
-* Removes a key/value-pair from the map by using the key.
+* @copydoc cxMapRemoveAndGet()
-*
-* This function will copy the contents to the target buffer
-* which must be guaranteed to be large enough to hold the element.
-* The destructor functions, if any, will \em not be called.
-*
-* If this map is storing pointers, the element is the pointer itself
-* and not the object it points to.
-*
-* @param map the map
-* @param key the key
-* @param targetbuf the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
 */
 cx_attr_nonnull
 cx_attr_access_w(3)
 static inline int cx_map_remove_and_get_mustr(
 CxMap *map,
 ) {
 return map->cl->remove(map, cx_hash_key_cxstr(key), targetbuf);
 }
 /**
-* Removes a key/value-pair from the map by using the key.
+* @copydoc cxMapRemoveAndGet()
-*
-* This function will copy the contents to the target buffer
-* which must be guaranteed to be large enough to hold the element.
-* The destructor functions, if any, will \em not be called.
-*
-* If this map is storing pointers, the element is the pointer itself
-* and not the object it points to.
-*
-* @param map the map
-* @param key the key
-* @param targetbuf the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
 */
 cx_attr_nonnull
 cx_attr_access_w(3)
 cx_attr_cstr_arg(2)
 static inline int cx_map_remove_and_get_str(
 }
 /**
 * Removes a key/value-pair from the map by using the key.
 *
-* This function will copy the contents to the target buffer
+* This function will copy the contents of the removed element
-* which must be guaranteed to be large enough to hold the element.
+* to the target buffer must be guaranteed to be large enough
-* The destructor functions, if any, will \em not be called.
+* to hold the element (the map's element size).
+* The destructor functions, if any, will @em not be called.
 *
 * If this map is storing pointers, the element is the pointer itself
 * and not the object it points to.
 *
-* @param map the map
+* @param map (@c CxMap*) the map
-* @param key the key
+* @param key (@c CxHashKey, @c char*, @c cxstring, or @c cxmutstr) the key
-* @param targetbuf the buffer where the element shall be copied to
+* @param targetbuf (@c void*) the buffer where the element shall be copied to
-* @return zero on success, non-zero if the key was not found
+* @retval zero success
+* @retval non-zero the key was not found
 *
 * @see cxMapStorePointers()
 * @see cxMapRemove()
 */
 #define cxMapRemoveAndGet(map, key, targetbuf) _Generic((key), \

Mercurial > hg > ucx / file comparison

comparison: src/cx/map.h

src/cx/map.h