Ruby 2.7.7p221 (2022-11-24 revision 168ec2b1e5ad0e4688e963d9de019557c78feed9)
st.h
Go to the documentation of this file.
1/* This is a public domain general purpose hash table package
2 originally written by Peter Moore @ UCB.
3
4 The hash table data strutures were redesigned and the package was
5 rewritten by Vladimir Makarov <vmakarov@redhat.com>. */
6
7#ifndef RUBY_ST_H
8#define RUBY_ST_H 1
9
10#if defined(__cplusplus)
11extern "C" {
12#if 0
13} /* satisfy cc-mode */
14#endif
15#endif
16
17#include "ruby/defines.h"
18
20
21#if SIZEOF_LONG == SIZEOF_VOIDP
22typedef unsigned long st_data_t;
23#elif SIZEOF_LONG_LONG == SIZEOF_VOIDP
24typedef unsigned LONG_LONG st_data_t;
25#else
26# error ---->> st.c requires sizeof(void*) == sizeof(long) or sizeof(LONG_LONG) to be compiled. <<----
27#endif
28#define ST_DATA_T_DEFINED
29
30#ifndef CHAR_BIT
31# ifdef HAVE_LIMITS_H
32# include <limits.h>
33# else
34# define CHAR_BIT 8
35# endif
36#endif
37#ifndef _
38# define _(args) args
39#endif
40#ifndef ANYARGS
41# ifdef __cplusplus
42# define ANYARGS ...
43# else
44# define ANYARGS
45# endif
46#endif
47
48typedef struct st_table st_table;
49
51
52/* Maximal value of unsigned integer type st_index_t. */
53#define MAX_ST_INDEX_VAL (~(st_index_t) 0)
54
57
58typedef char st_check_for_sizeof_st_index_t[SIZEOF_VOIDP == (int)sizeof(st_index_t) ? 1 : -1];
59#define SIZEOF_ST_INDEX_T SIZEOF_VOIDP
60
61struct st_hash_type {
62 int (*compare)(st_data_t, st_data_t); /* st_compare_func* */
63 st_index_t (*hash)(st_data_t); /* st_hash_func* */
64};
65
66#define ST_INDEX_BITS (SIZEOF_ST_INDEX_T * CHAR_BIT)
67
68#if defined(HAVE_BUILTIN___BUILTIN_CHOOSE_EXPR) && defined(HAVE_BUILTIN___BUILTIN_TYPES_COMPATIBLE_P)
69# define ST_DATA_COMPATIBLE_P(type) \
70 __builtin_choose_expr(__builtin_types_compatible_p(type, st_data_t), 1, 0)
71#else
72# define ST_DATA_COMPATIBLE_P(type) 0
73#endif
74
76
77struct st_table_entry; /* defined in st.c */
78
79struct st_table {
80 /* Cached features of the table -- see st.c for more details. */
81 unsigned char entry_power, bin_power, size_ind;
82 /* How many times the table was rebuilt. */
83 unsigned int rebuilds_num;
84 const struct st_hash_type *type;
85 /* Number of entries currently in the table. */
87 /* Array of bins used for access by keys. */
89 /* Start and bound index of entries in array entries.
90 entries_starts and entries_bound are in interval
91 [0,allocated_entries]. */
93 /* Array of size 2^entry_power. */
95};
96
97#define st_is_member(table,key) st_lookup((table),(key),(st_data_t *)0)
98
100
102#define st_init_table rb_st_init_table
104#define st_init_table_with_size rb_st_init_table_with_size
106#define st_init_numtable rb_st_init_numtable
108#define st_init_numtable_with_size rb_st_init_numtable_with_size
110#define st_init_strtable rb_st_init_strtable
112#define st_init_strtable_with_size rb_st_init_strtable_with_size
114#define st_init_strcasetable rb_st_init_strcasetable
116#define st_init_strcasetable_with_size rb_st_init_strcasetable_with_size
117int rb_st_delete(st_table *, st_data_t *, st_data_t *); /* returns 0:notfound 1:deleted */
118#define st_delete rb_st_delete
120#define st_delete_safe rb_st_delete_safe
121int rb_st_shift(st_table *, st_data_t *, st_data_t *); /* returns 0:notfound 1:deleted */
122#define st_shift rb_st_shift
124#define st_insert rb_st_insert
126#define st_insert2 rb_st_insert2
128#define st_lookup rb_st_lookup
130#define st_get_key rb_st_get_key
131typedef int st_update_callback_func(st_data_t *key, st_data_t *value, st_data_t arg, int existing);
132/* *key may be altered, but must equal to the old key, i.e., the
133 * results of hash() are same and compare() returns 0, otherwise the
134 * behavior is undefined */
136#define st_update rb_st_update
140#define st_foreach_with_replace rb_st_foreach_with_replace
142#define st_foreach rb_st_foreach
144#define st_foreach_check rb_st_foreach_check
146#define st_keys rb_st_keys
148#define st_keys_check rb_st_keys_check
150#define st_values rb_st_values
152#define st_values_check rb_st_values_check
154#define st_add_direct rb_st_add_direct
156#define st_free_table rb_st_free_table
158#define st_cleanup_safe rb_st_cleanup_safe
160#define st_clear rb_st_clear
162#define st_copy rb_st_copy
163CONSTFUNC(int rb_st_numcmp(st_data_t, st_data_t));
164#define st_numcmp rb_st_numcmp
166#define st_numhash rb_st_numhash
167PUREFUNC(int rb_st_locale_insensitive_strcasecmp(const char *s1, const char *s2));
168#define st_locale_insensitive_strcasecmp rb_st_locale_insensitive_strcasecmp
169PUREFUNC(int rb_st_locale_insensitive_strncasecmp(const char *s1, const char *s2, size_t n));
170#define st_locale_insensitive_strncasecmp rb_st_locale_insensitive_strncasecmp
171#define st_strcasecmp rb_st_locale_insensitive_strcasecmp
172#define st_strncasecmp rb_st_locale_insensitive_strncasecmp
173PUREFUNC(size_t rb_st_memsize(const st_table *));
174#define st_memsize rb_st_memsize
175PUREFUNC(st_index_t rb_st_hash(const void *ptr, size_t len, st_index_t h));
176#define st_hash rb_st_hash
178#define st_hash_uint32 rb_st_hash_uint32
180#define st_hash_uint rb_st_hash_uint
182#define st_hash_end rb_st_hash_end
184#define st_hash_start(h) ((st_index_t)(h))
185
187
189
190#if defined(__cplusplus)
191#if 0
192{ /* satisfy cc-mode */
193#endif
194} /* extern "C" { */
195#endif
196
197#endif /* RUBY_ST_H */
struct RIMemo * ptr
Definition: debug.c:65
__uint32_t uint32_t
int rb_st_locale_insensitive_strcasecmp(const char *s1, const char *s2)
unsigned long st_data_t
const char size_t n
#define RUBY_SYMBOL_EXPORT_BEGIN
const rb_iseq_t const char const VALUE keys
uint32_t i
int rb_st_locale_insensitive_strncasecmp(const char *s1, const char *s2, size_t n)
__inline__ const void *__restrict__ size_t len
#define SIZEOF_VOIDP
#define RUBY_SYMBOL_EXPORT_END
const char * s2
unsigned int size
st_data_t st_index_t
__inline__ int
size_t st_index_t h
#define LONG_LONG
unsigned long VALUE
Definition: ruby.h:102
st_index_t rb_st_hash_start(st_index_t h)
Definition: st.c:2069
@ ST_STOP
Definition: st.h:99
@ ST_CHECK
Definition: st.h:99
@ ST_DELETE
Definition: st.h:99
@ ST_REPLACE
Definition: st.h:99
@ ST_CONTINUE
Definition: st.h:99
st_table * rb_st_init_numtable_with_size(st_index_t)
int rb_st_insert2(st_table *, st_data_t, st_data_t, st_data_t(*)(st_data_t))
int st_foreach_check_callback_func(st_data_t, st_data_t, st_data_t, int)
Definition: st.h:138
st_table * rb_st_init_strcasetable_with_size(st_index_t)
int rb_st_shift(st_table *, st_data_t *, st_data_t *)
st_table * rb_st_init_strtable(void)
st_table * rb_st_init_table_with_size(const struct st_hash_type *, st_index_t)
char st_check_for_sizeof_st_index_t[SIZEOF_VOIDP==(int) sizeof(st_index_t) ? 1 :-1]
Definition: st.h:58
int rb_st_update(st_table *table, st_data_t key, st_update_callback_func *func, st_data_t arg)
st_table * rb_st_init_strtable_with_size(st_index_t)
int rb_st_get_key(st_table *, st_data_t, st_data_t *)
int rb_st_foreach_check(st_table *, st_foreach_check_callback_func *, st_data_t, st_data_t)
int rb_st_lookup(st_table *, st_data_t, st_data_t *)
void rb_st_cleanup_safe(st_table *, st_data_t)
st_index_t rb_st_keys(st_table *table, st_data_t *keys, st_index_t size)
st_index_t rb_st_values_check(st_table *table, st_data_t *values, st_index_t size, st_data_t never)
PUREFUNC(int rb_st_locale_insensitive_strcasecmp(const char *s1, const char *s2))
int rb_st_foreach(st_table *, st_foreach_callback_func *, st_data_t)
st_index_t rb_st_values(st_table *table, st_data_t *values, st_index_t size)
st_index_t st_hash_func(st_data_t)
Definition: st.h:56
int rb_st_insert(st_table *, st_data_t, st_data_t)
int st_compare_func(st_data_t, st_data_t)
Definition: st.h:55
void rb_st_add_direct(st_table *, st_data_t, st_data_t)
int st_update_callback_func(st_data_t *key, st_data_t *value, st_data_t arg, int existing)
Definition: st.h:131
st_table * rb_st_init_strcasetable(void)
void rb_st_free_table(st_table *)
st_table * rb_st_copy(st_table *)
int rb_st_foreach_with_replace(st_table *tab, st_foreach_check_callback_func *func, st_update_callback_func *replace, st_data_t arg)
st_data_t st_index_t
Definition: st.h:50
CONSTFUNC(int rb_st_numcmp(st_data_t, st_data_t))
int st_foreach_callback_func(st_data_t, st_data_t, st_data_t)
Definition: st.h:137
int rb_st_delete(st_table *, st_data_t *, st_data_t *)
st_table * rb_st_init_table(const struct st_hash_type *)
RUBY_SYMBOL_EXPORT_BEGIN typedef unsigned long st_data_t
Definition: st.h:22
void rb_hash_bulk_insert_into_st_table(long, const VALUE *, VALUE)
Definition: st.c:2379
st_table * rb_st_init_numtable(void)
st_index_t rb_st_keys_check(st_table *table, st_data_t *keys, st_index_t size, st_data_t never)
void rb_st_clear(st_table *)
int rb_st_delete_safe(st_table *, st_data_t *, st_data_t *, st_data_t)
st_index_t(* hash)(st_data_t)
int(* compare)(st_data_t, st_data_t)
Definition: st.c:136
unsigned char bin_power
st_table_entry * entries
unsigned int rebuilds_num
st_index_t entries_bound
unsigned char entry_power
const struct st_hash_type * type
unsigned char size_ind
st_index_t entries_start