map.h

Go to the documentation of this file.

/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 *   1. Redistributions of source code must retain the above copyright
 *      notice, this list of conditions and the following disclaimer.
 *
 *   2. Redistributions in binary form must reproduce the above copyright
 *      notice, this list of conditions and the following disclaimer in the
 *      documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * 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.
 */
#ifndef UCX_MAP_H
#define UCX_MAP_H
 
#include "common.h"
#include "collection.h"
#include "string.h"
#include "hash_key.h"
 
#ifdef    __cplusplus
extern "C" {
#endif
 
typedef struct cx_map_s CxMap;
 
typedef struct cx_map_entry_s CxMapEntry;
 
typedef struct cx_map_class_s cx_map_class;
 
struct cx_map_s {
    CX_COLLECTION_MEMBERS
    cx_map_class *cl;
};
 
enum cx_map_iterator_type {
    CX_MAP_ITERATOR_PAIRS,
    CX_MAP_ITERATOR_KEYS,
    CX_MAP_ITERATOR_VALUES
};
 
struct cx_map_class_s {
    __attribute__((__nonnull__))
    void (*destructor)(struct cx_map_s *map);
 
    __attribute__((__nonnull__))
    void (*clear)(struct cx_map_s *map);
 
    __attribute__((__nonnull__))
    int (*put)(
            CxMap *map,
            CxHashKey key,
            void *value
    );
 
    __attribute__((__nonnull__, __warn_unused_result__))
    void *(*get)(
            CxMap const *map,
            CxHashKey key
    );
 
    __attribute__((__nonnull__))
    void *(*remove)(
            CxMap *map,
            CxHashKey key,
            bool destroy
    );
 
    __attribute__((__nonnull__, __warn_unused_result__))
    CxIterator (*iterator)(CxMap const *map, enum cx_map_iterator_type type);
};
 
struct cx_map_entry_s {
    CxHashKey const *key;
    void *value;
};
 
extern CxMap *const cxEmptyMap;
 
__attribute__((__nonnull__))
static inline void cxMapStoreObjects(CxMap *map) {
    map->store_pointer = false;
}
 
__attribute__((__nonnull__))
static inline void cxMapStorePointers(CxMap *map) {
    map->store_pointer = true;
    map->item_size = sizeof(void *);
}
 
 
__attribute__((__nonnull__))
static inline void cxMapDestroy(CxMap *map) {
    map->cl->destructor(map);
}
 
 
__attribute__((__nonnull__))
static inline void cxMapClear(CxMap *map) {
    map->cl->clear(map);
}
 
 
// TODO: set-like map operations (union, intersect, difference)
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline CxIterator cxMapIteratorValues(CxMap const *map) {
    return map->cl->iterator(map, CX_MAP_ITERATOR_VALUES);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline CxIterator cxMapIteratorKeys(CxMap const *map) {
    return map->cl->iterator(map, CX_MAP_ITERATOR_KEYS);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline CxIterator cxMapIterator(CxMap const *map) {
    return map->cl->iterator(map, CX_MAP_ITERATOR_PAIRS);
}
 
 
__attribute__((__nonnull__, __warn_unused_result__))
CxMutIterator cxMapMutIteratorValues(CxMap *map);
 
__attribute__((__nonnull__, __warn_unused_result__))
CxMutIterator cxMapMutIteratorKeys(CxMap *map);
 
__attribute__((__nonnull__, __warn_unused_result__))
CxMutIterator cxMapMutIterator(CxMap *map);
 
#ifdef __cplusplus
} // end the extern "C" block here, because we want to start overloading
 
__attribute__((__nonnull__))
static inline int cxMapPut(
        CxMap *map,
        CxHashKey const &key,
        void *value
) {
    return map->cl->put(map, key, value);
}
 
 
__attribute__((__nonnull__))
static inline int cxMapPut(
        CxMap *map,
        cxstring const &key,
        void *value
) {
    return map->cl->put(map, cx_hash_key_cxstr(key), value);
}
 
__attribute__((__nonnull__))
static inline int cxMapPut(
        CxMap *map,
        cxmutstr const &key,
        void *value
) {
    return map->cl->put(map, cx_hash_key_cxstr(key), value);
}
 
__attribute__((__nonnull__))
static inline int cxMapPut(
        CxMap *map,
        char const *key,
        void *value
) {
    return map->cl->put(map, cx_hash_key_str(key), value);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cxMapGet(
        CxMap const *map,
        CxHashKey const &key
) {
    return map->cl->get(map, key);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cxMapGet(
        CxMap const *map,
        cxstring const &key
) {
    return map->cl->get(map, cx_hash_key_cxstr(key));
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cxMapGet(
        CxMap const *map,
        cxmutstr const &key
) {
    return map->cl->get(map, cx_hash_key_cxstr(key));
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cxMapGet(
        CxMap const *map,
        char const *key
) {
    return map->cl->get(map, cx_hash_key_str(key));
}
 
__attribute__((__nonnull__))
static inline void cxMapRemove(
        CxMap *map,
        CxHashKey const &key
) {
    (void) map->cl->remove(map, key, true);
}
 
__attribute__((__nonnull__))
static inline void cxMapRemove(
        CxMap *map,
        cxstring const &key
) {
    (void) map->cl->remove(map, cx_hash_key_cxstr(key), true);
}
 
__attribute__((__nonnull__))
static inline void cxMapRemove(
        CxMap *map,
        cxmutstr const &key
) {
    (void) map->cl->remove(map, cx_hash_key_cxstr(key), true);
}
 
__attribute__((__nonnull__))
static inline void cxMapRemove(
        CxMap *map,
        char const *key
) {
    (void) map->cl->remove(map, cx_hash_key_str(key), true);
}
 
__attribute__((__nonnull__))
static inline void cxMapDetach(
        CxMap *map,
        CxHashKey const &key
) {
    (void) map->cl->remove(map, key, false);
}
 
__attribute__((__nonnull__))
static inline void cxMapDetach(
        CxMap *map,
        cxstring const &key
) {
    (void) map->cl->remove(map, cx_hash_key_cxstr(key), false);
}
 
__attribute__((__nonnull__))
static inline void cxMapDetach(
        CxMap *map,
        cxmutstr const &key
) {
    (void) map->cl->remove(map, cx_hash_key_cxstr(key), false);
}
 
__attribute__((__nonnull__))
static inline void cxMapDetach(
        CxMap *map,
        char const *key
) {
    (void) map->cl->remove(map, cx_hash_key_str(key), false);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cxMapRemoveAndGet(
        CxMap *map,
        CxHashKey key
) {
    return map->cl->remove(map, key, !map->store_pointer);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cxMapRemoveAndGet(
        CxMap *map,
        cxstring key
) {
    return map->cl->remove(map, cx_hash_key_cxstr(key), !map->store_pointer);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cxMapRemoveAndGet(
        CxMap *map,
        cxmutstr key
) {
    return map->cl->remove(map, cx_hash_key_cxstr(key), !map->store_pointer);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cxMapRemoveAndGet(
        CxMap *map,
        char const *key
) {
    return map->cl->remove(map, cx_hash_key_str(key), !map->store_pointer);
}
 
#else // __cplusplus
 
__attribute__((__nonnull__))
static inline int cx_map_put(
        CxMap *map,
        CxHashKey key,
        void *value
) {
    return map->cl->put(map, key, value);
}
 
__attribute__((__nonnull__))
static inline int cx_map_put_cxstr(
        CxMap *map,
        cxstring key,
        void *value
) {
    return map->cl->put(map, cx_hash_key_cxstr(key), value);
}
 
__attribute__((__nonnull__))
static inline int cx_map_put_mustr(
        CxMap *map,
        cxmutstr key,
        void *value
) {
    return map->cl->put(map, cx_hash_key_cxstr(key), value);
}
 
__attribute__((__nonnull__))
static inline int cx_map_put_str(
        CxMap *map,
        char const *key,
        void *value
) {
    return map->cl->put(map, cx_hash_key_str(key), value);
}
 
#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,                        \
    char const*: cx_map_put_str)                  \
    (map, key, value)
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cx_map_get(
        CxMap const *map,
        CxHashKey key
) {
    return map->cl->get(map, key);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cx_map_get_cxstr(
        CxMap const *map,
        cxstring key
) {
    return map->cl->get(map, cx_hash_key_cxstr(key));
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cx_map_get_mustr(
        CxMap const *map,
        cxmutstr key
) {
    return map->cl->get(map, cx_hash_key_cxstr(key));
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cx_map_get_str(
        CxMap const *map,
        char const *key
) {
    return map->cl->get(map, cx_hash_key_str(key));
}
 
#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,                 \
    char const*: cx_map_get_str)           \
    (map, key)
 
__attribute__((__nonnull__))
static inline void cx_map_remove(
        CxMap *map,
        CxHashKey key
) {
    (void) map->cl->remove(map, key, true);
}
 
__attribute__((__nonnull__))
static inline void cx_map_remove_cxstr(
        CxMap *map,
        cxstring key
) {
    (void) map->cl->remove(map, cx_hash_key_cxstr(key), true);
}
 
__attribute__((__nonnull__))
static inline void cx_map_remove_mustr(
        CxMap *map,
        cxmutstr key
) {
    (void) map->cl->remove(map, cx_hash_key_cxstr(key), true);
}
 
__attribute__((__nonnull__))
static inline void cx_map_remove_str(
        CxMap *map,
        char const *key
) {
    (void) map->cl->remove(map, cx_hash_key_str(key), true);
}
 
#define cxMapRemove(map, key) _Generic((key), \
    CxHashKey: cx_map_remove,                 \
    cxstring: cx_map_remove_cxstr,            \
    cxmutstr: cx_map_remove_mustr,            \
    char*: cx_map_remove_str,                 \
    char const*: cx_map_remove_str)           \
    (map, key)
 
__attribute__((__nonnull__))
static inline void cx_map_detach(
        CxMap *map,
        CxHashKey key
) {
    (void) map->cl->remove(map, key, false);
}
 
__attribute__((__nonnull__))
static inline void cx_map_detach_cxstr(
        CxMap *map,
        cxstring key
) {
    (void) map->cl->remove(map, cx_hash_key_cxstr(key), false);
}
 
__attribute__((__nonnull__))
static inline void cx_map_detach_mustr(
        CxMap *map,
        cxmutstr key
) {
    (void) map->cl->remove(map, cx_hash_key_cxstr(key), false);
}
 
__attribute__((__nonnull__))
static inline void cx_map_detach_str(
        CxMap *map,
        char const *key
) {
    (void) map->cl->remove(map, cx_hash_key_str(key), false);
}
 
#define cxMapDetach(map, key) _Generic((key), \
    CxHashKey: cx_map_detach,                 \
    cxstring: cx_map_detach_cxstr,            \
    cxmutstr: cx_map_detach_mustr,            \
    char*: cx_map_detach_str,                 \
    char const*: cx_map_detach_str)           \
    (map, key)
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cx_map_remove_and_get(
        CxMap *map,
        CxHashKey key
) {
    return map->cl->remove(map, key, !map->store_pointer);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cx_map_remove_and_get_cxstr(
        CxMap *map,
        cxstring key
) {
    return map->cl->remove(map, cx_hash_key_cxstr(key), !map->store_pointer);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cx_map_remove_and_get_mustr(
        CxMap *map,
        cxmutstr key
) {
    return map->cl->remove(map, cx_hash_key_cxstr(key), !map->store_pointer);
}
 
__attribute__((__nonnull__, __warn_unused_result__))
static inline void *cx_map_remove_and_get_str(
        CxMap *map,
        char const *key
) {
    return map->cl->remove(map, cx_hash_key_str(key), !map->store_pointer);
}
 
#define cxMapRemoveAndGet(map, key) _Generic((key), \
    CxHashKey: cx_map_remove_and_get,               \
    cxstring: cx_map_remove_and_get_cxstr,          \
    cxmutstr: cx_map_remove_and_get_mustr,          \
    char*: cx_map_remove_and_get_str,               \
    char const*: cx_map_remove_and_get_str)         \
    (map, key)
 
#endif // __cplusplus
 
#endif // UCX_MAP_H