hash.h

00001 /*
00002 ** mruby/hash.h - Hash class
00003 **
00004 ** See Copyright Notice in mruby.h
00005 */
00006 
00007 #ifndef MRUBY_HASH_H
00008 #define MRUBY_HASH_H
00009 
00010 #if defined(__cplusplus)
00011 extern "C" {
00012 #endif
00013 
00014 struct RHash {
00015   MRB_OBJECT_HEADER;
00016   struct iv_tbl *iv;
00017   struct kh_ht *ht;
00018 };
00019 
00020 #define mrb_hash_ptr(v)    ((struct RHash*)(mrb_ptr(v)))
00021 #define mrb_hash_value(p)  mrb_obj_value((void*)(p))
00022 
00023 MRB_API mrb_value mrb_hash_new_capa(mrb_state*, int);
00024 MRB_API mrb_value mrb_hash_new(mrb_state *mrb);
00025 
00026 MRB_API void mrb_hash_set(mrb_state *mrb, mrb_value hash, mrb_value key, mrb_value val);
00027 MRB_API mrb_value mrb_hash_get(mrb_state *mrb, mrb_value hash, mrb_value key);
00028 MRB_API mrb_value mrb_hash_fetch(mrb_state *mrb, mrb_value hash, mrb_value key, mrb_value def);
00029 MRB_API mrb_value mrb_hash_delete_key(mrb_state *mrb, mrb_value hash, mrb_value key);
00030 MRB_API mrb_value mrb_hash_keys(mrb_state *mrb, mrb_value hash);
00031 MRB_API mrb_value mrb_check_hash_type(mrb_state *mrb, mrb_value hash);
00032 MRB_API mrb_value mrb_hash_empty_p(mrb_state *mrb, mrb_value self);
00033 MRB_API mrb_value mrb_hash_clear(mrb_state *mrb, mrb_value hash);
00034 
00035 /* RHASH_TBL allocates st_table if not available. */
00036 #define RHASH(obj)   ((struct RHash*)(mrb_ptr(obj)))
00037 #define RHASH_TBL(h)          (RHASH(h)->ht)
00038 #define RHASH_IFNONE(h)       mrb_iv_get(mrb, (h), mrb_intern_lit(mrb, "ifnone"))
00039 #define RHASH_PROCDEFAULT(h)  RHASH_IFNONE(h)
00040 MRB_API struct kh_ht * mrb_hash_tbl(mrb_state *mrb, mrb_value hash);
00041 
00042 #define MRB_HASH_PROC_DEFAULT 256
00043 #define MRB_RHASH_PROCDEFAULT_P(h) (RHASH(h)->flags & MRB_HASH_PROC_DEFAULT)
00044 
00045 /* GC functions */
00046 void mrb_gc_mark_hash(mrb_state*, struct RHash*);
00047 size_t mrb_gc_mark_hash_size(mrb_state*, struct RHash*);
00048 void mrb_gc_free_hash(mrb_state*, struct RHash*);
00049 
00050 #if defined(__cplusplus)
00051 }  /* extern "C" { */
00052 #endif
00053 
00054 #endif  /* MRUBY_HASH_H */
00055