#if !defined(_KV_H_)

#define _KV_H_ 1

#include <rtti.h>
#include <stdint.h>
#include <stdlib.h>
#include <sys/types.h>

typedef uint32_t (*kv_key_hash_fn_t)(void*);
typedef int (*kv_key_assign_fn_t)(void**, void*);
typedef int (*kv_key_cmp_fn_t)(void*, void*);
typedef void (*kv_key_destroy_fn_t)(void*);

typedef struct {
    kv_key_hash_fn_t    hash;
    kv_key_assign_fn_t  assign;
    kv_key_cmp_fn_t     cmp;
    kv_key_destroy_fn_t destroy;
} kv_key_ops_t;

typedef struct {
    uint32_t      nslots;
    kv_key_ops_t* keyops;
    destroy_fn_t  datakiller;
} kv_params_t;

extern typeinfo_t   kvtab_type;
extern kv_key_ops_t int_key_ops;
extern kv_key_ops_t string_key_ops;

extern int key_cmp_default(void*, void*, size_t);

/*
 * kvtab_foreach — iterate every live entry in the kvtab (P0-14).
 *
 * For each entry, cb(key, index, arg) is called.
 * - key   : the raw key pointer stored in the entry (char* for
 *           string-keyed tables, (void*)(long)intval for int-keyed).
 * - index : the slot index stored as the entry value.
 * - arg   : caller-supplied context.
 *
 * Iteration order is unspecified.
 * Returns the number of entries visited, or -EINVAL if kvtab is NULL.
 */
typedef void (*kvtab_foreach_fn_t)(void* key, int index, void* arg);
extern int kvtab_foreach(var                kvtab,
                         kvtab_foreach_fn_t cb,
                         void*              arg);

#endif