sdbht.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: pancake <pancake@nopcode.org>
// SPDX-License-Identifier: MIT
 
#ifndef __SDB_HT_H
#define __SDB_HT_H
 
#include "ht_pp.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct sdb_kv {
    // sub of HtPPKv so we can cast safely
    HtPPKv base;
    ut32 cas;
    ut64 expire;
} SdbKv;
 
static inline char *sdbkv_key(const SdbKv *kv) {
    return (char *)kv->base.key;
}
 
static inline char *sdbkv_value(const SdbKv *kv) {
    return (char *)kv->base.value;
}
 
static inline ut32 sdbkv_key_len(const SdbKv *kv) {
    return kv->base.key_len;
}
 
static inline ut32 sdbkv_value_len(const SdbKv *kv) {
    return kv->base.value_len;
}
 
RZ_API SdbKv *sdbkv_new2(const char *k, int kl, const char *v, int vl);
RZ_API SdbKv *sdbkv_new(const char *k, const char *v);
extern RZ_API void sdbkv_free(SdbKv *kv);
 
extern RZ_API ut32 sdb_hash(const char *key);
 
RZ_API HtPP *sdb_ht_new(void);
// Destroy a hashtable and all of its entries.
RZ_API void sdb_ht_free(HtPP *ht);
// Insert a new Key-Value pair into the hashtable. If the key already exists, returns false.
RZ_API bool sdb_ht_insert(HtPP *ht, const char *key, const char *value);
// Insert a new Key-Value pair into the hashtable, or updates the value if the key already exists.
RZ_API bool sdb_ht_insert_kvp(HtPP *ht, SdbKv *kvp, bool update);
// Insert a new Key-Value pair into the hashtable, or updates the value if the key already exists.
RZ_API bool sdb_ht_update(HtPP *ht, const char *key, const char *value);
// Delete a key from the hashtable.
RZ_API bool sdb_ht_delete(HtPP *ht, const char *key);
// Find the value corresponding to the matching key.
RZ_API char *sdb_ht_find(HtPP *ht, const char *key, bool *found);
// Find the KeyValuePair corresponding to the matching key.
RZ_API SdbKv *sdb_ht_find_kvp(HtPP *ht, const char *key, bool *found);
 
#ifdef __cplusplus
}
#endif
 
#endif // __SDB_HT_H