htable.h

Go to the documentation of this file.

#ifndef JABBERWERX_UTIL_HTABLE_H
#define JABBERWERX_UTIL_HTABLE_H

#include "../basics.h"


typedef struct _jw_htable jw_htable;

typedef struct _jw_hnode jw_hnode;


typedef unsigned int (*jw_htable_hashfunc)(const void *key);

typedef int (*jw_htable_cmpfunc)(const void *key1, const void *key2);

typedef int (*jw_htable_walkfunc)(void *user_data, const void *key, void *data);

typedef void (*jw_htable_cleanfunc)(
        bool replace, bool destroy_key, void *key, void *data);


#ifdef __cplusplus
extern "C"
{
#endif

JABBERWERX_API const void *jw_hnode_get_key(jw_hnode *node);

JABBERWERX_API void *jw_hnode_get_value(jw_hnode *node);

JABBERWERX_API void jw_hnode_put_value(jw_hnode           *node,
                                       void               *data,
                                       jw_htable_cleanfunc cleaner);

JABBERWERX_API bool jw_htable_create(int                buckets,
                                     jw_htable_hashfunc hash,
                                     jw_htable_cmpfunc  cmp,
                                     jw_htable        **tbl,
                                     jw_err            *err);

JABBERWERX_API void jw_htable_destroy(jw_htable *tbl);

JABBERWERX_API unsigned int jw_htable_get_count(jw_htable *tbl);

JABBERWERX_API jw_hnode *jw_htable_get_node(jw_htable  *tbl,
                                            const void *key);

JABBERWERX_API void jw_htable_remove_node(jw_htable *tbl,
                                          jw_hnode  *node);

JABBERWERX_API void *jw_htable_get(jw_htable  *tbl,
                                   const void *key);

JABBERWERX_API bool jw_htable_put(jw_htable          *tbl,
                                  const void         *key,
                                  void               *value,
                                  jw_htable_cleanfunc cleaner,
                                  jw_err             *err);

JABBERWERX_API void jw_htable_remove(jw_htable  *tbl,
                                     const void *key);

JABBERWERX_API void jw_htable_clear(jw_htable *tbl);

JABBERWERX_API jw_hnode *jw_htable_get_first_node(jw_htable *tbl);

JABBERWERX_API jw_hnode *jw_htable_get_next_node(jw_htable *tbl,
                                                 jw_hnode  *cur);

JABBERWERX_API unsigned int jw_htable_walk(jw_htable         *tbl,
                                           jw_htable_walkfunc func,
                                           void              *user_data);

JABBERWERX_API unsigned int jw_str_hashcode(const void *key);

JABBERWERX_API extern jw_htable_cmpfunc jw_str_compare;

JABBERWERX_API unsigned int jw_strcase_hashcode(const void *key);

JABBERWERX_API extern jw_htable_cmpfunc jw_strcase_compare;

JABBERWERX_API unsigned int jw_int_hashcode(const void *key);

JABBERWERX_API int jw_int_compare(const void *key1, const void *key2);

JABBERWERX_API void jw_htable_free_data_cleaner(
        bool replace, bool destroy_key, void *key, void *data);

#ifdef __cplusplus
}
#endif

#endif /* JABBERWERX_UTIL_HTABLE_H */