14#include "ruby/internal/config.h"
17#include "ccan/list/list.h"
19#include "debug_counter.h"
23#include "internal/box.h"
24#include "internal/class.h"
25#include "internal/compilers.h"
26#include "internal/error.h"
27#include "internal/eval.h"
28#include "internal/hash.h"
29#include "internal/object.h"
30#include "internal/gc.h"
31#include "internal/re.h"
32#include "internal/struct.h"
33#include "internal/symbol.h"
34#include "internal/thread.h"
35#include "internal/variable.h"
43#include "ractor_core.h"
47#define GET_GLOBAL_CVAR_STATE() (ruby_vm_global_cvar_state)
49typedef void rb_gvar_compact_t(
void *var);
57static VALUE autoload_features;
62static VALUE autoload_mutex;
64static void check_before_mod_set(
VALUE,
ID,
VALUE,
const char *);
65static void setup_const_entry(rb_const_entry_t *,
VALUE,
VALUE, rb_const_flag_t);
66static VALUE rb_const_search(
VALUE klass,
ID id,
int exclude,
int recurse,
int visibility,
VALUE *found_in);
67static st_table *generic_fields_tbl_;
69typedef int rb_ivar_foreach_callback_func(
ID key,
VALUE val, st_data_t arg);
70static void rb_field_foreach(
VALUE obj, rb_ivar_foreach_callback_func *func, st_data_t arg,
bool ivar_only);
75 rb_global_tbl = rb_id_table_create(0);
76 generic_fields_tbl_ = st_init_numtable();
81 rb_vm_register_global_object(autoload_mutex);
83 autoload_features = rb_ident_hash_new();
85 rb_vm_register_global_object(autoload_features);
89rb_namespace_p(
VALUE obj)
110classname(
VALUE klass,
bool *permanent)
114 VALUE classpath = RCLASS_CLASSPATH(klass);
115 if (classpath == 0)
return Qnil;
117 *permanent = RCLASS_PERMANENT_CLASSPATH_P(klass);
123rb_mod_name0(
VALUE klass,
bool *permanent)
125 return classname(klass, permanent);
140 return classname(mod, &permanent);
145is_constant_path(
VALUE name)
147 const char *path = RSTRING_PTR(name);
149 rb_encoding *enc = rb_enc_get(name);
151 const char *p = path;
153 if (p >= pend || !*p) {
158 if (p + 2 <= pend && p[0] ==
':' && p[1] ==
':') {
162 const char *pbeg = p;
163 while (p < pend && *p !=
':') p++;
165 if (pbeg == p)
return false;
167 if (rb_enc_symname_type(pbeg, p - pbeg, enc, 0) != ID_CONST) {
184set_sub_temporary_name_recursive(
VALUE mod,
VALUE data,
int recursive)
186 if (recursive)
return Qfalse;
191 name = build_const_path(rb_ary_last(0, 0, args->names), args->last);
193 set_sub_temporary_name_foreach(mod, args, name);
198set_sub_temporary_name_topmost(
VALUE mod,
VALUE data,
int recursive)
200 if (recursive)
return Qfalse;
203 VALUE name = args->names;
207 set_sub_temporary_name_foreach(mod, args, name);
211static enum rb_id_table_iterator_result
212set_sub_temporary_name_i(
ID id,
VALUE val,
void *data)
214 val = ((rb_const_entry_t *)val)->value;
215 if (rb_namespace_p(val) && !RCLASS_PERMANENT_CLASSPATH_P(val)) {
221 return ID_TABLE_CONTINUE;
227 RCLASS_WRITE_CLASSPATH(mod, name, FALSE);
231 rb_id_table_foreach(tbl, set_sub_temporary_name_i, args);
236 rb_id_table_foreach(tbl, set_sub_temporary_name_i, args);
237 rb_ary_set_len(args->names, names_len);
298rb_mod_set_temporary_name(
VALUE mod,
VALUE name)
301 if (RCLASS_PERMANENT_CLASSPATH_P(mod)) {
308 set_sub_temporary_name(mod, 0);
315 if (RSTRING_LEN(name) == 0) {
316 rb_raise(rb_eArgError,
"empty class/module name");
319 if (is_constant_path(name)) {
320 rb_raise(rb_eArgError,
"the temporary name must not be a constant path to avoid confusion");
324 RB_OBJ_SET_SHAREABLE(name);
328 set_sub_temporary_name(mod, name);
341 path = rb_sprintf(
"#<Class:%p>", (
void*)obj);
344 path = rb_sprintf(
"#<Module:%p>", (
void*)obj);
347 path = rb_sprintf(
"#<%"PRIsVALUE
":%p>", klass, (
void*)obj);
357rb_tmp_class_path(
VALUE klass,
bool *permanent, fallback_func fallback)
359 VALUE path = classname(klass, permanent);
371 path = rb_tmp_class_path(
RBASIC(klass)->klass, &perm, fallback);
376 return fallback(klass, path);
383 VALUE path = rb_tmp_class_path(klass, &permanent, make_temporary_path);
401rb_search_class_path(
VALUE klass)
404 return rb_tmp_class_path(klass, &permanent, no_fallback);
413 return rb_fstring(path);
417build_const_path(
VALUE head,
ID tail)
419 return build_const_pathname(head, rb_id2str(tail));
425 bool permanent =
true;
428 if (under == rb_cObject) {
432 str = rb_tmp_class_path(under, &permanent, make_temporary_path);
433 str = build_const_pathname(str, name);
436 RB_OBJ_SET_SHAREABLE(str);
437 RCLASS_SET_CLASSPATH(klass, str, permanent);
451 rb_encoding *enc = rb_enc_get(pathname);
452 const char *pbeg, *pend, *p, *path = RSTRING_PTR(pathname);
454 VALUE c = rb_cObject;
456 if (!rb_enc_asciicompat(enc)) {
457 rb_raise(rb_eArgError,
"invalid class path encoding (non ASCII)");
460 pend = path + RSTRING_LEN(pathname);
461 if (path == pend || path[0] ==
'#') {
462 rb_raise(rb_eArgError,
"can't retrieve anonymous class %"PRIsVALUE,
466 while (p < pend && *p !=
':') p++;
468 if (p < pend && p[0] ==
':') {
469 if ((
size_t)(pend - p) < 2 || p[1] !=
':')
goto undefined_class;
474 goto undefined_class;
476 c = rb_const_search(c,
id, TRUE, FALSE, FALSE, NULL);
477 if (UNDEF_P(c))
goto undefined_class;
478 if (!rb_namespace_p(c)) {
479 rb_raise(
rb_eTypeError,
"%"PRIsVALUE
" does not refer to class/module",
488 rb_raise(rb_eArgError,
"undefined class/module % "PRIsVALUE,
509 VALUE path = rb_tmp_class_path(
rb_class_real(klass), &permanent, make_temporary_path);
510 if (
NIL_P(path))
return NULL;
511 return RSTRING_PTR(path);
534 rb_gvar_compact_t *compactor;
560static enum rb_id_table_iterator_result
561free_global_entry_i(
VALUE val,
void *arg)
564 entry->var->counter--;
565 if (entry->var->counter == 0) {
566 free_global_variable(entry->var);
569 return ID_TABLE_DELETE;
573rb_free_rb_global_tbl(
void)
575 rb_id_table_foreach_values(rb_global_tbl, free_global_entry_i, 0);
576 rb_id_table_free(rb_global_tbl);
580rb_free_generic_fields_tbl_(
void)
582 st_free_table(generic_fields_tbl_);
586rb_find_global_entry(
ID id)
592 if (!rb_id_table_lookup(rb_global_tbl,
id, &data)) {
601 if (UNLIKELY(!rb_ractor_main_p()) && (!entry || !entry->ractor_local)) {
602 rb_raise(rb_eRactorIsolationError,
"can not access global variable %s from non-main Ractor", rb_id2name(
id));
609rb_gvar_ractor_local(
const char *name)
612 entry->ractor_local =
true;
616rb_gvar_box_ready(
const char *name)
619 entry->var->box_ready =
true;
623rb_gvar_box_dynamic(
const char *name)
626 entry->var->box_dynamic =
true;
630rb_gvar_undef_compactor(
void *var)
639 entry = rb_find_global_entry(
id);
646 entry->ractor_local =
false;
652 var->compactor = rb_gvar_undef_compactor;
654 var->block_trace = 0;
656 var->box_ready =
false;
657 var->box_dynamic =
false;
658 rb_id_table_insert(rb_global_tbl,
id, (
VALUE)entry);
667 rb_warning(
"global variable '%"PRIsVALUE
"' not initialized", QUOTE_ID(
id));
673rb_gvar_val_compactor(
void *_var)
680 VALUE new = rb_gc_location(obj);
682 var->data = (
void*)
new;
694 var->compactor = rb_gvar_val_compactor;
696 var->data = (
void*)val;
714 var->data = (
void*)val;
721 if (data) rb_gc_mark_movable(data);
727 if (!var)
return Qnil;
740 if (var) rb_gc_mark_maybe(*var);
746 rb_name_error(
id,
"%"PRIsVALUE
" is a read-only variable", QUOTE_ID(
id));
749static enum rb_id_table_iterator_result
750mark_global_entry(
VALUE v,
void *ignored)
756 (*var->marker)(var->data);
759 if (trace->data) rb_gc_mark_maybe(trace->data);
762 return ID_TABLE_CONTINUE;
765#define gc_mark_table(task) \
766 if (rb_global_tbl) { rb_id_table_foreach_values(rb_global_tbl, task##_global_entry, 0); }
769rb_gc_mark_global_tbl(
void)
774static enum rb_id_table_iterator_result
775update_global_entry(
VALUE v,
void *ignored)
780 (*var->compactor)(var);
781 return ID_TABLE_CONTINUE;
785rb_gc_update_global_tbl(
void)
787 gc_mark_table(update);
791global_id(
const char *name)
795 if (name[0] ==
'$')
id = rb_intern(name);
797 size_t len = strlen(name);
801 memcpy(buf+1, name,
len);
802 id = rb_intern2(buf,
len+1);
809find_global_id(
const char *name)
812 size_t len = strlen(name);
814 if (name[0] ==
'$') {
821 memcpy(buf+1, name,
len);
837 ID id = global_id(name);
840 gvar->data = (
void*)var;
892 trace->next = entry->var->trace;
893 trace->func = rb_trace_eval;
896 entry->var->trace = trace;
910 while (trace->next) {
913 trace->next = next->next;
936 if ((entry = rb_find_global_entry(
id)) == NULL) {
937 rb_name_error(
id,
"undefined global variable %"PRIsVALUE
"", QUOTE_ID(
id));
940 trace = entry->var->trace;
951 if (!entry->var->block_trace) remove_trace(entry->var);
956 if (trace->data == cmd) {
958 if (!entry->var->block_trace) remove_trace(entry->var);
979 (*trace->func)(trace->data, data->val);
990 var->block_trace = 0;
1001 (*var->setter)(val, entry->id, var->data);
1003 if (var->trace && !var->block_trace) {
1004 var->block_trace = 1;
1005 trace.trace = var->trace;
1013gvar_use_box_tbl(
const rb_box_t *box,
const struct rb_global_entry *entry)
1015 return BOX_USER_P(box) &&
1016 !entry->var->box_dynamic &&
1025 const rb_box_t *box = rb_current_box();
1026 bool use_box_tbl =
false;
1031 if (gvar_use_box_tbl(box, entry)) {
1033 rb_hash_aset(box->gvar_tbl,
rb_id2sym(entry->id), val);
1040 retval = rb_gvar_set_entry(entry, val);
1048 return rb_gvar_set(global_id(name), val);
1054 VALUE retval, gvars, key;
1055 const rb_box_t *box = rb_current_box();
1056 bool use_box_tbl =
false;
1064 if (gvar_use_box_tbl(box, entry)) {
1066 gvars = box->gvar_tbl;
1068 if (
RTEST(rb_hash_has_key(gvars, key))) {
1069 retval = rb_hash_aref(gvars, key);
1074 retval = (*var->getter)(entry->id, var->data);
1076 retval =
rb_funcall(retval, rb_intern(
"clone"), 0);
1080 rb_hash_aset(gvars, key, retval);
1085 retval = (*var->getter)(entry->id, var->data);
1093 ID id = find_global_id(name);
1096 rb_warning(
"global variable '%s' not initialized", name);
1100 return rb_gvar_get(
id);
1104rb_gvar_defined(
ID id)
1111rb_gvar_getter_function_of(
ID id)
1114 return entry->var->getter;
1118rb_gvar_setter_function_of(
ID id)
1121 return entry->var->setter;
1124static enum rb_id_table_iterator_result
1125gvar_i(
ID key,
VALUE val,
void *a)
1129 return ID_TABLE_CONTINUE;
1138 if (!rb_ractor_main_p()) {
1139 rb_raise(rb_eRactorIsolationError,
"can not access global variables from non-main Ractors");
1143 rb_id_table_foreach(rb_global_tbl, gvar_i, (
void *)ary);
1144 if (!
NIL_P(backref)) {
1146 int i, nmatch = rb_match_count(backref);
1148 for (i = 1; i <= nmatch; ++i) {
1152 buf[1] = (char)(i +
'0');
1153 sym =
ID2SYM(rb_intern2(buf, 2));
1172 if (!rb_ractor_main_p()) {
1173 rb_raise(rb_eRactorIsolationError,
"can not access global variables from non-main Ractors");
1178 if (!rb_id_table_lookup(gtbl, name1, &data1)) {
1181 rb_id_table_insert(gtbl, name1, (
VALUE)entry1);
1183 else if ((entry1 = (
struct rb_global_entry *)data1)->var != entry2->var) {
1185 if (var->block_trace) {
1190 if (var->counter == 0) {
1191 free_global_variable(var);
1194 if (entry1->var != entry2->var) {
1195 entry2->var->counter++;
1196 entry1->var = entry2->var;
1202IVAR_ACCESSOR_SHOULD_BE_MAIN_RACTOR(
ID id)
1204 if (UNLIKELY(!rb_ractor_main_p())) {
1206 rb_raise(rb_eRactorIsolationError,
"can not set instance variables of classes/modules by non-main Ractors");
1212CVAR_ACCESSOR_SHOULD_BE_MAIN_RACTOR(
VALUE klass,
ID id)
1214 if (UNLIKELY(!rb_ractor_main_p())) {
1215 rb_raise(rb_eRactorIsolationError,
"can not access class variables from non-main Ractors (%"PRIsVALUE
" from %"PRIsVALUE
")", rb_id2str(
id), klass);
1220ivar_ractor_check(
VALUE obj,
ID id)
1224 UNLIKELY(!rb_ractor_main_p()) &&
1227 rb_raise(rb_eRactorIsolationError,
"can not access instance variables of shareable objects from non-main Ractors");
1231static inline struct st_table *
1232generic_fields_tbl_no_ractor_check(
void)
1234 ASSERT_vm_locking();
1236 return generic_fields_tbl_;
1240rb_generic_fields_tbl_get(
void)
1242 return generic_fields_tbl_;
1246rb_mark_generic_ivar(
VALUE obj)
1250 if (st_lookup(generic_fields_tbl_, (st_data_t)obj, (st_data_t *)&data)) {
1251 rb_gc_mark_movable(data);
1256rb_obj_fields_generic_uncached(
VALUE obj)
1258 VALUE fields_obj = 0;
1260 if (!st_lookup(generic_fields_tbl_, (st_data_t)obj, (st_data_t *)&fields_obj)) {
1261 rb_bug(
"Object is missing entry in generic_fields_tbl");
1268rb_obj_fields(
VALUE obj,
ID field_name)
1271 ivar_ractor_check(obj, field_name);
1273 VALUE fields_obj = 0;
1274 if (rb_shape_obj_has_fields(obj)) {
1281 goto generic_fields;
1283 if (LIKELY(!
FL_TEST_RAW(obj, RSTRUCT_GEN_FIELDS))) {
1284 fields_obj = RSTRUCT_FIELDS_OBJ(obj);
1287 goto generic_fields;
1291 rb_execution_context_t *ec = GET_EC();
1292 if (ec->gen_fields_cache.obj == obj && !UNDEF_P(ec->gen_fields_cache.fields_obj) && rb_imemo_fields_owner(ec->gen_fields_cache.fields_obj) == obj) {
1293 fields_obj = ec->gen_fields_cache.fields_obj;
1294 RUBY_ASSERT(fields_obj == rb_obj_fields_generic_uncached(obj));
1297 fields_obj = rb_obj_fields_generic_uncached(obj);
1298 ec->gen_fields_cache.fields_obj = fields_obj;
1299 ec->gen_fields_cache.obj = obj;
1310 if (rb_obj_gen_fields_p(obj)) {
1311 st_data_t key = (st_data_t)obj, value;
1318 goto generic_fields;
1320 if (LIKELY(!
FL_TEST_RAW(obj, RSTRUCT_GEN_FIELDS))) {
1321 RSTRUCT_SET_FIELDS_OBJ(obj, 0);
1324 goto generic_fields;
1330 rb_execution_context_t *ec = GET_EC();
1331 if (ec->gen_fields_cache.obj == obj) {
1332 ec->gen_fields_cache.obj =
Qundef;
1333 ec->gen_fields_cache.fields_obj =
Qundef;
1336 if (!st_delete(generic_fields_tbl_no_ractor_check(), &key, &value)) {
1337 rb_bug(
"Object is missing entry in generic_fields_tbl");
1342 RBASIC_SET_SHAPE_ID(obj, ROOT_SHAPE_ID);
1347rb_obj_set_fields(
VALUE obj,
VALUE fields_obj,
ID field_name,
VALUE original_fields_obj)
1349 ivar_ractor_check(obj, field_name);
1354 rb_imemo_fields_clear(original_fields_obj);
1358 RUBY_ASSERT(IMEMO_TYPE_P(fields_obj, imemo_fields));
1359 RUBY_ASSERT(!original_fields_obj || IMEMO_TYPE_P(original_fields_obj, imemo_fields));
1361 if (fields_obj != original_fields_obj) {
1368 goto generic_fields;
1370 if (LIKELY(!
FL_TEST_RAW(obj, RSTRUCT_GEN_FIELDS))) {
1371 RSTRUCT_SET_FIELDS_OBJ(obj, fields_obj);
1374 goto generic_fields;
1379 st_insert(generic_fields_tbl_, (st_data_t)obj, (st_data_t)fields_obj);
1383 rb_execution_context_t *ec = GET_EC();
1384 if (ec->gen_fields_cache.fields_obj != fields_obj) {
1385 ec->gen_fields_cache.obj = obj;
1386 ec->gen_fields_cache.fields_obj = fields_obj;
1391 if (original_fields_obj) {
1393 rb_imemo_fields_clear(original_fields_obj);
1397 RBASIC_SET_SHAPE_ID(obj, RBASIC_SHAPE_ID(fields_obj));
1401rb_obj_replace_fields(
VALUE obj,
VALUE fields_obj)
1404 VALUE original_fields_obj = rb_obj_fields_no_ractor_check(obj);
1405 rb_obj_set_fields(obj, fields_obj, 0, original_fields_obj);
1410rb_obj_field_get(
VALUE obj, shape_id_t target_shape_id)
1413 RUBY_ASSERT(RSHAPE_TYPE_P(target_shape_id, SHAPE_IVAR) || RSHAPE_TYPE_P(target_shape_id, SHAPE_OBJ_ID));
1420 fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(obj);
1430 fields_obj = rb_obj_fields(obj, RSHAPE_EDGE_NAME(target_shape_id));
1434 if (UNLIKELY(rb_shape_too_complex_p(target_shape_id))) {
1435 st_table *fields_hash = rb_imemo_fields_complex_tbl(fields_obj);
1437 st_lookup(fields_hash, RSHAPE_EDGE_NAME(target_shape_id), &value);
1442 attr_index_t index = RSHAPE_INDEX(target_shape_id);
1443 return rb_imemo_fields_ptr(fields_obj)[index];
1457 VALUE val = rb_ivar_lookup(RCLASS_WRITABLE_FIELDS_OBJ(obj),
id, undef);
1460 UNLIKELY(!rb_ractor_main_p()) &&
1462 rb_raise(rb_eRactorIsolationError,
1463 "can not get unshareable values from instance variables of classes/modules from non-main Ractors (%"PRIsVALUE
" from %"PRIsVALUE
")",
1464 rb_id2str(
id), obj);
1477 fields_obj = rb_obj_fields(obj,
id);
1485 shape_id_t shape_id = RBASIC_SHAPE_ID(fields_obj);
1487 if (UNLIKELY(rb_shape_too_complex_p(shape_id))) {
1488 st_table *iv_table = rb_imemo_fields_complex_tbl(fields_obj);
1490 if (rb_st_lookup(iv_table, (st_data_t)
id, (st_data_t *)&val)) {
1496 attr_index_t index = 0;
1497 if (rb_shape_get_iv_index(shape_id,
id, &index)) {
1498 return rb_imemo_fields_ptr(fields_obj)[index];
1507 VALUE iv = rb_ivar_lookup(obj,
id,
Qnil);
1508 RB_DEBUG_COUNTER_INC(ivar_get_base);
1513rb_ivar_get_at(
VALUE obj, attr_index_t index,
ID id)
1524 VALUE fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(obj);
1525 VALUE val = rb_imemo_fields_ptr(fields_obj)[index];
1528 rb_raise(rb_eRactorIsolationError,
1529 "can not get unshareable values from instance variables of classes/modules from non-main Ractors");
1536 VALUE fields_obj = rb_obj_fields(obj,
id);
1537 return rb_imemo_fields_ptr(fields_obj)[index];
1543rb_ivar_get_at_no_ractor_check(
VALUE obj, attr_index_t index)
1553 fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(obj);
1556 fields_obj = rb_obj_fields_no_ractor_check(obj);
1559 return rb_imemo_fields_ptr(fields_obj)[index];
1565 return rb_ivar_lookup(obj,
id,
Qnil);
1568void rb_obj_copy_fields_to_hash_table(
VALUE obj, st_table *table);
1569static VALUE imemo_fields_complex_from_obj(
VALUE owner,
VALUE source_fields_obj, shape_id_t shape_id);
1572obj_transition_too_complex(
VALUE obj, st_table *table)
1575 shape_id_t shape_id = rb_shape_transition_complex(obj);
1580 VALUE *old_fields = NULL;
1587 RBASIC_SET_SHAPE_ID(obj, shape_id);
1588 ROBJECT_SET_FIELDS_HASH(obj, table);
1602 RBASIC_SET_SHAPE_ID(fields_obj, shape_id);
1603 rb_obj_replace_fields(obj, fields_obj);
1612rb_evict_fields_to_hash(
VALUE obj)
1616 st_table *table = st_init_numtable_with_size(RSHAPE_LEN(RBASIC_SHAPE_ID(obj)));
1617 rb_obj_copy_fields_to_hash_table(obj, table);
1618 shape_id_t new_shape_id = obj_transition_too_complex(obj, table);
1621 return new_shape_id;
1625rb_evict_ivars_to_hash(
VALUE obj)
1629 st_table *table = st_init_numtable_with_size(
rb_ivar_count(obj));
1632 rb_obj_copy_ivs_to_hash_table(obj, table);
1633 obj_transition_too_complex(obj, table);
1641 rb_check_frozen(obj);
1645 bool concurrent =
false;
1651 IVAR_ACCESSOR_SHOULD_BE_MAIN_RACTOR(
id);
1653 fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(obj);
1654 if (rb_multi_ractor_p()) {
1662 fields_obj = rb_obj_fields(obj,
id);
1671 const VALUE original_fields_obj = fields_obj;
1673 fields_obj = rb_imemo_fields_clone(fields_obj);
1676 shape_id_t old_shape_id = RBASIC_SHAPE_ID(fields_obj);
1677 shape_id_t removed_shape_id;
1678 shape_id_t next_shape_id = rb_shape_transition_remove_ivar(fields_obj,
id, &removed_shape_id);
1680 if (UNLIKELY(rb_shape_too_complex_p(next_shape_id))) {
1681 if (UNLIKELY(!rb_shape_too_complex_p(old_shape_id))) {
1683 rb_evict_fields_to_hash(obj);
1686 fields_obj = imemo_fields_complex_from_obj(obj, fields_obj, next_shape_id);
1690 if (!st_delete(rb_imemo_fields_complex_tbl(fields_obj), &key, (st_data_t *)&val)) {
1695 if (next_shape_id == old_shape_id) {
1699 RUBY_ASSERT(removed_shape_id != INVALID_SHAPE_ID);
1700 RUBY_ASSERT(RSHAPE_LEN(next_shape_id) == RSHAPE_LEN(old_shape_id) - 1);
1702 VALUE *fields = rb_imemo_fields_ptr(fields_obj);
1703 attr_index_t removed_index = RSHAPE_INDEX(removed_shape_id);
1704 val = fields[removed_index];
1706 attr_index_t new_fields_count = RSHAPE_LEN(next_shape_id);
1707 if (new_fields_count) {
1708 size_t trailing_fields = new_fields_count - removed_index;
1710 MEMMOVE(&fields[removed_index], &fields[removed_index + 1],
VALUE, trailing_fields);
1711 RBASIC_SET_SHAPE_ID(fields_obj, next_shape_id);
1718 MEMCPY(rb_imemo_fields_ptr(fields_obj), fields,
VALUE, new_fields_count);
1728 RBASIC_SET_SHAPE_ID(obj, next_shape_id);
1729 if (fields_obj != original_fields_obj) {
1735 RCLASS_WRITABLE_SET_FIELDS_OBJ(obj, fields_obj);
1738 rb_obj_set_fields(obj, fields_obj,
id, original_fields_obj);
1747rb_attr_delete(
VALUE obj,
ID id)
1749 return rb_ivar_delete(obj,
id,
Qnil);
1753rb_obj_init_too_complex(
VALUE obj, st_table *table)
1757 RUBY_ASSERT(rb_shape_canonical_p(RBASIC_SHAPE_ID(obj)));
1758 RUBY_ASSERT(RSHAPE_LEN(RBASIC_SHAPE_ID(obj)) == 0);
1760 obj_transition_too_complex(obj, table);
1764imemo_fields_complex_from_obj_i(
ID key,
VALUE val, st_data_t arg)
1767 st_table *table = rb_imemo_fields_complex_tbl(fields);
1769 RUBY_ASSERT(!st_lookup(table, (st_data_t)key, NULL));
1770 st_add_direct(table, (st_data_t)key, (st_data_t)val);
1777imemo_fields_complex_from_obj(
VALUE owner,
VALUE source_fields_obj, shape_id_t shape_id)
1779 attr_index_t
len = source_fields_obj ? RSHAPE_LEN(RBASIC_SHAPE_ID(source_fields_obj)) : 0;
1782 rb_field_foreach(source_fields_obj, imemo_fields_complex_from_obj_i, (st_data_t)fields_obj,
false);
1783 RBASIC_SET_SHAPE_ID(fields_obj, shape_id);
1789imemo_fields_copy_capa(
VALUE owner,
VALUE source_fields_obj, attr_index_t new_size)
1792 if (source_fields_obj) {
1793 attr_index_t fields_count = RSHAPE_LEN(RBASIC_SHAPE_ID(source_fields_obj));
1794 VALUE *fields = rb_imemo_fields_ptr(fields_obj);
1795 MEMCPY(fields, rb_imemo_fields_ptr(source_fields_obj),
VALUE, fields_count);
1796 RBASIC_SET_SHAPE_ID(fields_obj, RBASIC_SHAPE_ID(source_fields_obj));
1797 for (attr_index_t i = 0; i < fields_count; i++) {
1805imemo_fields_set(
VALUE owner,
VALUE fields_obj, shape_id_t target_shape_id,
ID field_name,
VALUE val,
bool concurrent)
1807 const VALUE original_fields_obj = fields_obj;
1808 shape_id_t current_shape_id = fields_obj ? RBASIC_SHAPE_ID(fields_obj) : ROOT_SHAPE_ID;
1810 if (UNLIKELY(rb_shape_too_complex_p(target_shape_id))) {
1811 if (rb_shape_too_complex_p(current_shape_id)) {
1816 fields_obj = rb_imemo_fields_clone(fields_obj);
1820 fields_obj = imemo_fields_complex_from_obj(owner, original_fields_obj, target_shape_id);
1821 current_shape_id = target_shape_id;
1824 st_table *table = rb_imemo_fields_complex_tbl(fields_obj);
1827 st_insert(table, (st_data_t)field_name, (st_data_t)val);
1829 RBASIC_SET_SHAPE_ID(fields_obj, target_shape_id);
1832 attr_index_t index = RSHAPE_INDEX(target_shape_id);
1833 if (concurrent || index >= RSHAPE_CAPACITY(current_shape_id)) {
1834 fields_obj = imemo_fields_copy_capa(owner, original_fields_obj, RSHAPE_CAPACITY(target_shape_id));
1837 VALUE *table = rb_imemo_fields_ptr(fields_obj);
1840 if (RSHAPE_LEN(target_shape_id) > RSHAPE_LEN(current_shape_id)) {
1841 RBASIC_SET_SHAPE_ID(fields_obj, target_shape_id);
1849generic_field_set(
VALUE obj, shape_id_t target_shape_id,
ID field_name,
VALUE val)
1852 field_name = RSHAPE_EDGE_NAME(target_shape_id);
1856 const VALUE original_fields_obj = rb_obj_fields(obj, field_name);
1857 VALUE fields_obj = imemo_fields_set(obj, original_fields_obj, target_shape_id, field_name, val,
false);
1859 rb_obj_set_fields(obj, fields_obj, field_name, original_fields_obj);
1860 return rb_shape_too_complex_p(target_shape_id) ? ATTR_INDEX_NOT_SET : RSHAPE_INDEX(target_shape_id);
1864generic_shape_ivar(
VALUE obj,
ID id,
bool *new_ivar_out)
1866 bool new_ivar =
false;
1867 shape_id_t current_shape_id = RBASIC_SHAPE_ID(obj);
1868 shape_id_t target_shape_id = current_shape_id;
1870 if (!rb_shape_too_complex_p(current_shape_id)) {
1871 if (!rb_shape_find_ivar(current_shape_id,
id, &target_shape_id)) {
1872 if (RSHAPE_LEN(current_shape_id) >= SHAPE_MAX_FIELDS) {
1873 rb_raise(rb_eArgError,
"too many instance variables");
1877 target_shape_id = rb_shape_transition_add_ivar(obj,
id);
1881 *new_ivar_out = new_ivar;
1882 return target_shape_id;
1889 shape_id_t target_shape_id = generic_shape_ivar(obj,
id, &dontcare);
1890 return generic_field_set(obj, target_shape_id,
id, val);
1894rb_ensure_iv_list_size(
VALUE obj, uint32_t current_len, uint32_t new_capacity)
1906 ROBJECT(obj)->as.heap.fields = newptr;
1911rb_obj_copy_ivs_to_hash_table_i(
ID key,
VALUE val, st_data_t arg)
1913 RUBY_ASSERT(!st_lookup((st_table *)arg, (st_data_t)key, NULL));
1915 st_add_direct((st_table *)arg, (st_data_t)key, (st_data_t)val);
1920rb_obj_copy_ivs_to_hash_table(
VALUE obj, st_table *table)
1922 rb_ivar_foreach(obj, rb_obj_copy_ivs_to_hash_table_i, (st_data_t)table);
1926rb_obj_copy_fields_to_hash_table(
VALUE obj, st_table *table)
1928 rb_field_foreach(obj, rb_obj_copy_ivs_to_hash_table_i, (st_data_t)table,
false);
1932obj_field_set(
VALUE obj, shape_id_t target_shape_id,
ID field_name,
VALUE val)
1934 shape_id_t current_shape_id = RBASIC_SHAPE_ID(obj);
1936 if (UNLIKELY(rb_shape_too_complex_p(target_shape_id))) {
1937 if (UNLIKELY(!rb_shape_too_complex_p(current_shape_id))) {
1938 current_shape_id = rb_evict_fields_to_hash(obj);
1941 if (RSHAPE_LEN(target_shape_id) > RSHAPE_LEN(current_shape_id)) {
1942 RBASIC_SET_SHAPE_ID(obj, target_shape_id);
1946 field_name = RSHAPE_EDGE_NAME(target_shape_id);
1950 st_insert(ROBJECT_FIELDS_HASH(obj), (st_data_t)field_name, (st_data_t)val);
1953 return ATTR_INDEX_NOT_SET;
1956 attr_index_t index = RSHAPE_INDEX(target_shape_id);
1958 if (index >= RSHAPE_LEN(current_shape_id)) {
1959 if (UNLIKELY(index >= RSHAPE_CAPACITY(current_shape_id))) {
1960 rb_ensure_iv_list_size(obj, RSHAPE_CAPACITY(current_shape_id), RSHAPE_CAPACITY(target_shape_id));
1962 RBASIC_SET_SHAPE_ID(obj, target_shape_id);
1975 shape_id_t target_shape_id = generic_shape_ivar(obj,
id, &dontcare);
1976 return obj_field_set(obj, target_shape_id,
id, val);
1986 rb_check_frozen(obj);
1987 obj_ivar_set(obj,
id, val);
1999 RB_SET_SHAPE_ID(x, rb_shape_transition_frozen(x));
2007static attr_index_t class_ivar_set(
VALUE obj,
ID id,
VALUE val,
bool *new_ivar);
2012 RB_DEBUG_COUNTER_INC(ivar_set_base);
2016 return obj_ivar_set(obj,
id, val);
2020 IVAR_ACCESSOR_SHOULD_BE_MAIN_RACTOR(
id);
2022 return class_ivar_set(obj,
id, val, &dontcare);
2025 return generic_ivar_set(obj,
id, val);
2032 rb_check_frozen(obj);
2033 ivar_set(obj,
id, val);
2040 return ivar_set(obj,
id, val);
2049 ivar_set(obj,
id, val);
2053rb_obj_field_set(
VALUE obj, shape_id_t target_shape_id,
ID field_name,
VALUE val)
2057 return obj_field_set(obj, target_shape_id, field_name, val);
2061 rb_bug(
"Unreachable");
2064 return generic_field_set(obj, target_shape_id, field_name, val);
2069ivar_defined0(
VALUE obj,
ID id)
2073 if (rb_shape_obj_too_complex_p(obj)) {
2075 st_table *table = NULL;
2079 rb_bug(
"Unreachable");
2084 table = rb_imemo_fields_complex_tbl(obj);
2088 table = ROBJECT_FIELDS_HASH(obj);
2092 VALUE fields_obj = rb_obj_fields_no_ractor_check(obj);
2093 table = rb_imemo_fields_complex_tbl(fields_obj);
2097 if (!table || !rb_st_lookup(table,
id, &idx)) {
2104 return RBOOL(rb_shape_get_iv_index(RBASIC_SHAPE_ID(obj),
id, &index));
2118 VALUE fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(obj);
2120 defined = ivar_defined0(fields_obj,
id);
2125 defined = ivar_defined0(obj,
id);
2133 struct gen_fields_tbl *fields_tbl;
2135 rb_ivar_foreach_callback_func *func;
2137 shape_id_t shape_id;
2142iterate_over_shapes_callback(shape_id_t shape_id,
void *data)
2146 if (itr_data->ivar_only && !RSHAPE_TYPE_P(shape_id, SHAPE_IVAR)) {
2153 RUBY_ASSERT(!rb_shape_obj_too_complex_p(itr_data->obj));
2157 RUBY_ASSERT(IMEMO_TYPE_P(itr_data->obj, imemo_fields));
2158 RUBY_ASSERT(!rb_shape_obj_too_complex_p(itr_data->obj));
2160 fields = rb_imemo_fields_ptr(itr_data->obj);
2163 rb_bug(
"Unreachable");
2166 RUBY_ASSERT(itr_data->shape_id == RBASIC_SHAPE_ID(itr_data->obj));
2168 VALUE val = fields[RSHAPE_INDEX(shape_id)];
2169 int ret = itr_data->func(RSHAPE_EDGE_NAME(shape_id), val, itr_data->arg);
2171 RUBY_ASSERT(itr_data->shape_id == RBASIC_SHAPE_ID(itr_data->obj));
2180iterate_over_shapes(shape_id_t shape_id, rb_ivar_foreach_callback_func *callback,
struct iv_itr_data *itr_data)
2182 rb_shape_foreach_field(shape_id, iterate_over_shapes_callback, itr_data);
2186each_hash_iv(st_data_t
id, st_data_t val, st_data_t data)
2189 rb_ivar_foreach_callback_func *callback = itr_data->func;
2190 if (is_internal_id((
ID)
id)) {
2193 return callback((
ID)
id, (
VALUE)val, itr_data->arg);
2197obj_fields_each(
VALUE obj, rb_ivar_foreach_callback_func *func, st_data_t arg,
bool ivar_only)
2203 .ivar_only = ivar_only,
2206 shape_id_t shape_id = RBASIC_SHAPE_ID(obj);
2207 if (rb_shape_too_complex_p(shape_id)) {
2208 st_foreach_safe(ROBJECT_FIELDS_HASH(obj), each_hash_iv, (st_data_t)&itr_data);
2212 itr_data.shape_id = shape_id;
2213 iterate_over_shapes(shape_id, func, &itr_data);
2218imemo_fields_each(
VALUE fields_obj, rb_ivar_foreach_callback_func *func, st_data_t arg,
bool ivar_only)
2220 IMEMO_TYPE_P(fields_obj, imemo_fields);
2226 .ivar_only = ivar_only,
2229 shape_id_t shape_id = RBASIC_SHAPE_ID(fields_obj);
2230 if (rb_shape_too_complex_p(shape_id)) {
2231 rb_st_foreach(rb_imemo_fields_complex_tbl(fields_obj), each_hash_iv, (st_data_t)&itr_data);
2234 itr_data.fields = rb_imemo_fields_ptr(fields_obj);
2235 itr_data.shape_id = shape_id;
2236 iterate_over_shapes(shape_id, func, &itr_data);
2243 VALUE new_fields_obj;
2245 rb_check_frozen(dest);
2247 if (!rb_obj_gen_fields_p(obj)) {
2251 shape_id_t src_shape_id = rb_obj_shape_id(obj);
2253 VALUE fields_obj = rb_obj_fields_no_ractor_check(obj);
2260 if (rb_shape_too_complex_p(src_shape_id)) {
2261 rb_shape_copy_complex_ivars(dest, obj, src_shape_id, rb_imemo_fields_complex_tbl(fields_obj));
2265 shape_id_t dest_shape_id = src_shape_id;
2266 shape_id_t initial_shape_id = rb_obj_shape_id(dest);
2268 if (!rb_shape_canonical_p(src_shape_id)) {
2269 RUBY_ASSERT(RSHAPE_TYPE_P(initial_shape_id, SHAPE_ROOT));
2271 dest_shape_id = rb_shape_rebuild(initial_shape_id, src_shape_id);
2272 if (UNLIKELY(rb_shape_too_complex_p(dest_shape_id))) {
2273 st_table *table = rb_st_init_numtable_with_size(src_num_ivs);
2274 rb_obj_copy_ivs_to_hash_table(obj, table);
2275 rb_obj_init_too_complex(dest, table);
2280 if (!RSHAPE_LEN(dest_shape_id)) {
2281 RBASIC_SET_SHAPE_ID(dest, dest_shape_id);
2285 new_fields_obj = rb_imemo_fields_new(dest, RSHAPE_CAPACITY(dest_shape_id),
RB_OBJ_SHAREABLE_P(dest));
2286 VALUE *src_buf = rb_imemo_fields_ptr(fields_obj);
2287 VALUE *dest_buf = rb_imemo_fields_ptr(new_fields_obj);
2288 rb_shape_copy_fields(new_fields_obj, dest_buf, dest_shape_id, src_buf, src_shape_id);
2289 RBASIC_SET_SHAPE_ID(new_fields_obj, dest_shape_id);
2291 rb_obj_replace_fields(dest, new_fields_obj);
2300rb_replace_generic_ivar(
VALUE clone,
VALUE obj)
2303 st_data_t fields_tbl, obj_data = (st_data_t)obj;
2304 if (st_delete(generic_fields_tbl_, &obj_data, &fields_tbl)) {
2305 st_insert(generic_fields_tbl_, (st_data_t)clone, fields_tbl);
2309 rb_bug(
"unreachable");
2315rb_field_foreach(
VALUE obj, rb_ivar_foreach_callback_func *func, st_data_t arg,
bool ivar_only)
2320 if (IMEMO_TYPE_P(obj, imemo_fields)) {
2321 imemo_fields_each(obj, func, arg, ivar_only);
2325 obj_fields_each(obj, func, arg, ivar_only);
2330 IVAR_ACCESSOR_SHOULD_BE_MAIN_RACTOR(0);
2331 VALUE fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(obj);
2333 imemo_fields_each(fields_obj, func, arg, ivar_only);
2339 VALUE fields_obj = rb_obj_fields_no_ractor_check(obj);
2341 imemo_fields_each(fields_obj, func, arg, ivar_only);
2354collect_ivar_i(
ID id,
VALUE val, st_data_t arg)
2366 rb_field_foreach(obj, func, arg,
true);
2370rb_ivar_foreach_buffered(
VALUE obj, rb_ivar_foreach_callback_func *func, st_data_t arg)
2373 if (count == 0)
return;
2379 rb_field_foreach(obj, collect_ivar_i, (st_data_t)&pos,
true);
2382 for (st_index_t i = 0; i < count; i++) {
2383 if (func(buf[i].name, buf[i].val, arg) == ST_STOP)
break;
2394 st_index_t iv_count = 0;
2397 iv_count = ROBJECT_FIELDS_COUNT(obj);
2403 VALUE fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(obj);
2407 if (rb_shape_obj_too_complex_p(fields_obj)) {
2408 iv_count = rb_st_table_size(rb_imemo_fields_complex_tbl(fields_obj));
2411 iv_count = RBASIC_FIELDS_COUNT(fields_obj);
2419 if (rb_shape_obj_too_complex_p(obj)) {
2420 iv_count = rb_st_table_size(rb_imemo_fields_complex_tbl(obj));
2423 iv_count = RBASIC_FIELDS_COUNT(obj);
2429 VALUE fields_obj = rb_obj_fields_no_ractor_check(obj);
2431 if (rb_shape_obj_too_complex_p(fields_obj)) {
2432 iv_count = rb_st_table_size(rb_imemo_fields_complex_tbl(fields_obj));
2435 iv_count = RBASIC_FIELDS_COUNT(obj);
2442 if (rb_shape_obj_has_id(obj)) {
2450ivar_i(
ID key,
VALUE v, st_data_t a)
2487#define rb_is_constant_id rb_is_const_id
2488#define rb_is_constant_name rb_is_const_name
2489#define id_for_var(obj, name, part, type) \
2490 id_for_var_message(obj, name, type, "'%1$s' is not allowed as "#part" "#type" variable name")
2491#define id_for_var_message(obj, name, type, message) \
2492 check_id_type(obj, &(name), rb_is_##type##_id, rb_is_##type##_name, message, strlen(message))
2495 int (*valid_id_p)(
ID),
int (*valid_name_p)(
VALUE),
2496 const char *message,
size_t message_len)
2499 VALUE name = *pname;
2501 if (
id ? !valid_id_p(
id) : !valid_name_p(name)) {
2502 rb_name_err_raise_str(rb_fstring_new(message, message_len),
2534 const ID id = id_for_var(obj, name, an, instance);
2538 rb_check_frozen(obj);
2543 if (!UNDEF_P(val))
return val;
2546 rb_name_err_raise(
"instance variable %1$s not defined",
2551NORETURN(
static void uninitialized_constant(
VALUE,
VALUE));
2553uninitialized_constant(
VALUE klass,
VALUE name)
2556 rb_name_err_raise(
"uninitialized constant %2$s::%1$s",
2559 rb_name_err_raise(
"uninitialized constant %1$s",
2566 VALUE value = rb_funcallv(klass, idConst_missing, 1, &name);
2567 rb_vm_inc_const_missing_count();
2615 rb_execution_context_t *ec = GET_EC();
2616 VALUE ref = ec->private_const_reference;
2617 rb_vm_pop_cfunc_frame();
2619 ec->private_const_reference = 0;
2620 rb_name_err_raise(
"private constant %2$s::%1$s referenced", ref, name);
2622 uninitialized_constant(klass, name);
2628autoload_table_mark(
void *ptr)
2630 rb_mark_tbl_no_pin((st_table *)ptr);
2634autoload_table_free(
void *ptr)
2636 st_free_table((st_table *)ptr);
2640autoload_table_memsize(
const void *ptr)
2642 const st_table *tbl = ptr;
2643 return st_memsize(tbl);
2647autoload_table_compact(
void *ptr)
2649 rb_gc_ref_update_table_values_only((st_table *)ptr);
2654 {autoload_table_mark, autoload_table_free, autoload_table_memsize, autoload_table_compact,},
2655 0, 0, RUBY_TYPED_FREE_IMMEDIATELY | RUBY_TYPED_WB_PROTECTED
2658#define check_autoload_table(av) \
2659 (struct st_table *)rb_check_typeddata((av), &autoload_table_type)
2664 struct st_table *tbl;
2670 if (RICLASS_IS_ORIGIN_P(mod)) {
2674 mod =
RBASIC(mod)->klass;
2682 VALUE tbl_value = rb_ivar_lookup(mod, autoload,
Qfalse);
2683 if (!
RTEST(tbl_value) || !(tbl = check_autoload_table(tbl_value)) || !st_lookup(tbl, (st_data_t)
id, &val)) {
2693 struct ccan_list_node cnode;
2696 VALUE autoload_data_value;
2712 rb_const_flag_t flag;
2728 rb_serial_t fork_gen;
2731 struct ccan_list_head constants;
2735autoload_data_mark_and_move(
void *ptr)
2739 rb_gc_mark_and_move(&p->feature);
2740 rb_gc_mark_and_move(&p->mutex);
2744autoload_data_free(
void *ptr)
2749 ccan_list_for_each_safe(&p->constants,
autoload_const, next, cnode) {
2757autoload_data_memsize(
const void *ptr)
2764 {autoload_data_mark_and_move, autoload_data_free, autoload_data_memsize, autoload_data_mark_and_move},
2765 0, 0, RUBY_TYPED_FREE_IMMEDIATELY | RUBY_TYPED_WB_PROTECTED
2769autoload_const_mark_and_move(
void *ptr)
2773 rb_gc_mark_and_move(&ac->module);
2774 rb_gc_mark_and_move(&ac->autoload_data_value);
2775 rb_gc_mark_and_move(&ac->value);
2776 rb_gc_mark_and_move(&ac->file);
2777 rb_gc_mark_and_move(&ac->box_value);
2781autoload_const_memsize(
const void *ptr)
2787autoload_const_free(
void *ptr)
2797 {autoload_const_mark_and_move, autoload_const_free, autoload_const_memsize, autoload_const_mark_and_move,},
2798 0, 0, RUBY_TYPED_FREE_IMMEDIATELY | RUBY_TYPED_WB_PROTECTED
2802get_autoload_data(
VALUE autoload_const_value,
struct autoload_const **autoload_const_pointer)
2815 if (autoload_const_pointer) *autoload_const_pointer =
autoload_const;
2821 VALUE dst_tbl_value;
2823 const rb_box_t *box;
2827autoload_copy_table_for_box_i(st_data_t key, st_data_t value, st_data_t arg)
2831 struct st_table *tbl = data->dst_tbl;
2832 VALUE tbl_value = data->dst_tbl_value;
2833 const rb_box_t *box = data->box;
2838 VALUE autoload_data_value = src_const->autoload_data_value;
2850 st_insert(tbl, (st_data_t)
autoload_const->name, (st_data_t)new_value);
2857rb_autoload_copy_table_for_box(st_table *iv_ptr,
const rb_box_t *box)
2859 struct st_table *src_tbl, *dst_tbl;
2860 VALUE src_tbl_value, dst_tbl_value;
2861 if (!rb_st_lookup(iv_ptr, (st_data_t)autoload, (st_data_t *)&src_tbl_value)) {
2865 if (!
RTEST(src_tbl_value) || !(src_tbl = check_autoload_table(src_tbl_value))) {
2869 src_tbl = check_autoload_table(src_tbl_value);
2875 .dst_tbl_value = dst_tbl_value,
2880 st_foreach(src_tbl, autoload_copy_table_for_box_i, (st_data_t)&data);
2881 st_insert(iv_ptr, (st_data_t)autoload, (st_data_t)dst_tbl_value);
2885rb_autoload(
VALUE module,
ID name,
const char *feature)
2887 if (!feature || !*feature) {
2888 rb_raise(rb_eArgError,
"empty feature name");
2891 rb_autoload_str(module, name, rb_fstring_cstr(feature));
2895static void const_added(
VALUE klass,
ID const_name);
2905autoload_feature_lookup_or_create(
VALUE feature,
struct autoload_data **autoload_data_pointer)
2907 RUBY_ASSERT_MUTEX_OWNED(autoload_mutex);
2908 RUBY_ASSERT_CRITICAL_SECTION_ENTER();
2910 VALUE autoload_data_value = rb_hash_aref(autoload_features, feature);
2913 if (
NIL_P(autoload_data_value)) {
2919 if (autoload_data_pointer) *autoload_data_pointer =
autoload_data;
2921 rb_hash_aset(autoload_features, feature, autoload_data_value);
2923 else if (autoload_data_pointer) {
2924 *autoload_data_pointer =
rb_check_typeddata(autoload_data_value, &autoload_data_type);
2927 RUBY_ASSERT_CRITICAL_SECTION_LEAVE();
2928 return autoload_data_value;
2932autoload_table_lookup_or_create(
VALUE module)
2934 VALUE autoload_table_value = rb_ivar_lookup(module, autoload,
Qfalse);
2935 if (
RTEST(autoload_table_value)) {
2936 return autoload_table_value;
2940 rb_class_ivar_set(module, autoload, autoload_table_value);
2942 return autoload_table_value;
2947autoload_synchronized(
VALUE _arguments)
2951 rb_const_entry_t *constant_entry = rb_const_lookup(arguments->module, arguments->name);
2952 if (constant_entry && !UNDEF_P(constant_entry->value)) {
2957 const_set(arguments->module, arguments->name,
Qundef);
2959 VALUE autoload_table_value = autoload_table_lookup_or_create(arguments->module);
2960 struct st_table *autoload_table = check_autoload_table(autoload_table_value);
2963 VALUE feature = rb_fstring(arguments->feature);
2966 VALUE autoload_data_value = autoload_feature_lookup_or_create(feature, &
autoload_data);
2978 st_insert(autoload_table, (st_data_t)arguments->name, (st_data_t)autoload_const_value);
2988 const rb_box_t *box = rb_current_box();
2989 VALUE current_box_value = rb_get_box_object((rb_box_t *)box);
2992 rb_raise(
rb_eNameError,
"autoload must be constant name: %"PRIsVALUE
"", QUOTE_ID(name));
2996 if (!RSTRING_LEN(feature)) {
2997 rb_raise(rb_eArgError,
"empty feature name");
3004 .box_value = current_box_value,
3009 if (result ==
Qtrue) {
3010 const_added(module, name);
3015autoload_delete(
VALUE module,
ID name)
3017 RUBY_ASSERT_CRITICAL_SECTION_ENTER();
3019 st_data_t load = 0, key = name;
3023 VALUE table_value = rb_ivar_lookup(module, autoload,
Qfalse);
3024 if (
RTEST(table_value)) {
3025 struct st_table *table = check_autoload_table(table_value);
3027 st_delete(table, &key, &load);
3050 if (table->num_entries == 0) {
3051 rb_attr_delete(module, autoload);
3056 RUBY_ASSERT_CRITICAL_SECTION_LEAVE();
3062 return ele->mutex !=
Qnil && !rb_mutex_owned_p(ele->mutex);
3066check_autoload_required(
VALUE mod,
ID id,
const char **loadingpath)
3070 const char *loading;
3072 if (!autoload_const_value || !(
autoload_data = get_autoload_data(autoload_const_value, 0))) {
3085 return autoload_const_value;
3088 loading = RSTRING_PTR(feature);
3091 return autoload_const_value;
3094 if (loadingpath && loading) {
3095 *loadingpath = loading;
3096 return autoload_const_value;
3105rb_autoloading_value(
VALUE mod,
ID id,
VALUE* value, rb_const_flag_t *flag)
3108 if (!ac)
return FALSE;
3124 return ele->mutex !=
Qnil && rb_mutex_owned_p(ele->mutex);
3131autoloading_const_entry(
VALUE mod,
ID id)
3138 if (!load || !(ele = get_autoload_data(load, &ac))) {
3144 if (autoload_by_current(ele)) {
3145 if (!UNDEF_P(ac->value)) {
3154autoload_defined_p(
VALUE mod,
ID id)
3156 rb_const_entry_t *ce = rb_const_lookup(mod,
id);
3159 if (!ce || !UNDEF_P(ce->value)) {
3165 return !rb_autoloading_value(mod,
id, NULL, NULL);
3178 struct autoload_const *autoload_const;
3181 struct autoload_data *autoload_data;
3187 check_before_mod_set(ac->module, ac->name, ac->value,
"constant");
3190 const_tbl_update(ac,
true);
3197autoload_load_needed(
VALUE _arguments)
3201 const char *loading = 0, *src;
3203 if (!autoload_defined_p(arguments->module, arguments->name)) {
3207 VALUE autoload_const_value = check_autoload_required(arguments->module, arguments->name, &loading);
3208 if (!autoload_const_value) {
3213 if (src && loading && strcmp(src, loading) == 0) {
3234 return autoload_const_value;
3238autoload_apply_constants(
VALUE _arguments)
3240 RUBY_ASSERT_CRITICAL_SECTION_ENTER();
3252 ccan_list_for_each_safe(&arguments->autoload_data->constants,
autoload_const, next, cnode) {
3258 RUBY_ASSERT_CRITICAL_SECTION_LEAVE();
3264autoload_feature_require(
VALUE _arguments)
3266 VALUE receiver = rb_vm_top_self();
3276 if (rb_box_available() && BOX_OBJ_P(autoload_box_value))
3277 receiver = autoload_box_value;
3285 rb_gccct_clear_table(
Qnil);
3287 VALUE result =
rb_funcall(receiver, rb_intern(
"require"), 1, arguments->autoload_data->feature);
3289 if (
RTEST(result)) {
3296autoload_try_load(
VALUE _arguments)
3300 VALUE result = autoload_feature_require(_arguments);
3303 rb_const_entry_t *ce = rb_const_lookup(arguments->module, arguments->name);
3305 if (!ce || UNDEF_P(ce->value)) {
3310 if (arguments->module == rb_cObject) {
3312 "Expected %"PRIsVALUE
" to define %"PRIsVALUE
" but it didn't",
3313 arguments->autoload_data->feature,
3319 "Expected %"PRIsVALUE
" to define %"PRIsVALUE
"::%"PRIsVALUE
" but it didn't",
3320 arguments->autoload_data->feature,
3328 ce->flag |= arguments->flag;
3337 rb_const_entry_t *ce = rb_const_lookup(module, name);
3340 if (!ce || !UNDEF_P(ce->value)) {
3345 if (UNLIKELY(!rb_ractor_main_p())) {
3346 return rb_ractor_autoload_load(module, name);
3356 if (autoload_const_value ==
Qfalse)
return autoload_const_value;
3358 arguments.flag = ce->flag & (CONST_DEPRECATED | CONST_VISIBILITY_MASK);
3375 return rb_autoload_at_p(mod,
id, TRUE);
3379rb_autoload_at_p(
VALUE mod,
ID id,
int recur)
3384 while (!autoload_defined_p(mod,
id)) {
3385 if (!recur)
return Qnil;
3387 if (!mod)
return Qnil;
3389 load = check_autoload_required(mod,
id, 0);
3390 if (!load)
return Qnil;
3391 return (ele = get_autoload_data(load, 0)) ? ele->feature :
Qnil;
3395rb_const_warn_if_deprecated(
const rb_const_entry_t *ce,
VALUE klass,
ID id)
3397 if (RB_CONST_DEPRECATED_P(ce) &&
3399 if (klass == rb_cObject) {
3410rb_const_get_0(
VALUE klass,
ID id,
int exclude,
int recurse,
int visibility)
3413 VALUE c = rb_const_search(klass,
id, exclude, recurse, visibility, &found_in);
3415 if (UNLIKELY(!rb_ractor_main_p())) {
3417 rb_raise(rb_eRactorIsolationError,
"can not access non-shareable objects in constant %"PRIsVALUE
"::%"PRIsVALUE
" by non-main Ractor.",
rb_class_path(found_in), rb_id2str(
id));
3422 return rb_const_missing(klass,
ID2SYM(
id));
3426rb_const_search_from(
VALUE klass,
ID id,
int exclude,
int recurse,
int visibility,
VALUE *found_in)
3428 VALUE value, current;
3429 bool first_iteration =
true;
3431 for (current = klass;
3433 current =
RCLASS_SUPER(current), first_iteration =
false) {
3436 rb_const_entry_t *ce;
3438 if (!first_iteration && RCLASS_ORIGIN(current) != current) {
3451 while ((ce = rb_const_lookup(tmp,
id))) {
3452 if (visibility && RB_CONST_PRIVATE_P(ce)) {
3453 GET_EC()->private_const_reference = tmp;
3456 rb_const_warn_if_deprecated(ce, tmp,
id);
3458 if (UNDEF_P(value)) {
3460 if (am == tmp)
break;
3462 ac = autoloading_const_entry(tmp,
id);
3464 if (found_in) { *found_in = tmp; }
3470 if (exclude && tmp == rb_cObject) {
3473 if (found_in) { *found_in = tmp; }
3476 if (!recurse)
break;
3480 GET_EC()->private_const_reference = 0;
3485rb_const_search(
VALUE klass,
ID id,
int exclude,
int recurse,
int visibility,
VALUE *found_in)
3489 if (klass == rb_cObject) exclude = FALSE;
3490 value = rb_const_search_from(klass,
id, exclude, recurse, visibility, found_in);
3491 if (!UNDEF_P(value))
return value;
3492 if (exclude)
return value;
3495 return rb_const_search_from(rb_cObject,
id, FALSE, recurse, visibility, found_in);
3501 return rb_const_get_0(klass,
id, TRUE, TRUE, FALSE);
3507 return rb_const_get_0(klass,
id, FALSE, TRUE, FALSE);
3513 return rb_const_get_0(klass,
id, TRUE, FALSE, FALSE);
3517rb_public_const_get_from(
VALUE klass,
ID id)
3519 return rb_const_get_0(klass,
id, TRUE, TRUE, TRUE);
3523rb_public_const_get_at(
VALUE klass,
ID id)
3525 return rb_const_get_0(klass,
id, TRUE, FALSE, TRUE);
3528NORETURN(
static void undefined_constant(
VALUE mod,
VALUE name));
3532 rb_name_err_raise(
"constant %2$s::%1$s not defined",
3537rb_const_location_from(
VALUE klass,
ID id,
int exclude,
int recurse,
int visibility)
3539 while (
RTEST(klass)) {
3540 rb_const_entry_t *ce;
3542 while ((ce = rb_const_lookup(klass,
id))) {
3543 if (visibility && RB_CONST_PRIVATE_P(ce)) {
3546 if (exclude && klass == rb_cObject) {
3550 if (UNDEF_P(ce->value)) {
3552 if (
RTEST(autoload_const_value)) {
3565 if (!recurse)
break;
3574rb_const_location(
VALUE klass,
ID id,
int exclude,
int recurse,
int visibility)
3578 if (klass == rb_cObject) exclude = FALSE;
3579 loc = rb_const_location_from(klass,
id, exclude, recurse, visibility);
3580 if (!
NIL_P(loc))
return loc;
3581 if (exclude)
return loc;
3584 return rb_const_location_from(rb_cObject,
id, FALSE, recurse, visibility);
3588rb_const_source_location(
VALUE klass,
ID id)
3590 return rb_const_location(klass,
id, FALSE, TRUE, FALSE);
3594rb_const_source_location_at(
VALUE klass,
ID id)
3596 return rb_const_location(klass,
id, TRUE, FALSE, FALSE);
3612 const ID id = id_for_var(mod, name, a, constant);
3615 undefined_constant(mod, name);
3620static rb_const_entry_t * const_lookup(
struct rb_id_table *tbl,
ID id);
3626 rb_const_entry_t *ce;
3628 rb_check_frozen(mod);
3630 ce = rb_const_lookup(mod,
id);
3634 rb_name_err_raise(
"cannot remove %2$s::%1$s", mod,
ID2SYM(
id));
3637 undefined_constant(mod,
ID2SYM(
id));
3640 VALUE writable_ce = 0;
3641 if (rb_id_table_lookup(RCLASS_WRITABLE_CONST_TBL(mod),
id, &writable_ce)) {
3642 rb_id_table_delete(RCLASS_WRITABLE_CONST_TBL(mod),
id);
3643 if ((rb_const_entry_t *)writable_ce != ce) {
3644 xfree((rb_const_entry_t *)writable_ce);
3648 rb_const_warn_if_deprecated(ce, mod,
id);
3654 autoload_delete(mod,
id);
3658 if (ce != const_lookup(RCLASS_PRIME_CONST_TBL(mod),
id)) {
3667cv_i_update(st_data_t *k, st_data_t *v, st_data_t a,
int existing)
3669 if (existing)
return ST_STOP;
3674static enum rb_id_table_iterator_result
3677 rb_const_entry_t *ce = (rb_const_entry_t *)v;
3681 st_update(tbl, (st_data_t)key, cv_i_update, (st_data_t)ce);
3683 return ID_TABLE_CONTINUE;
3686static enum rb_id_table_iterator_result
3687rb_local_constants_i(
ID const_name,
VALUE const_value,
void *ary)
3689 if (
rb_is_const_id(const_name) && !RB_CONST_PRIVATE_P((rb_const_entry_t *)const_value)) {
3692 return ID_TABLE_CONTINUE;
3696rb_local_constants(
VALUE mod)
3705 rb_id_table_foreach(tbl, rb_local_constants_i, (
void *)ary);
3714 st_table *tbl = data;
3716 tbl = st_init_numtable();
3718 if (RCLASS_CONST_TBL(mod)) {
3720 rb_id_table_foreach(RCLASS_CONST_TBL(mod), sv_i, tbl);
3734 if (tmp == rb_cObject && mod != rb_cObject)
break;
3740list_i(st_data_t key, st_data_t value,
VALUE ary)
3743 rb_const_entry_t *ce = (rb_const_entry_t *)value;
3751 st_table *tbl = data;
3783 bool inherit =
true;
3791 return rb_local_constants(mod);
3796rb_const_defined_0(
VALUE klass,
ID id,
int exclude,
int recurse,
int visibility)
3800 rb_const_entry_t *ce;
3805 if ((ce = rb_const_lookup(tmp,
id))) {
3806 if (visibility && RB_CONST_PRIVATE_P(ce)) {
3809 if (UNDEF_P(ce->value) && !check_autoload_required(tmp,
id, 0) &&
3810 !rb_autoloading_value(tmp,
id, NULL, NULL))
3813 if (exclude && tmp == rb_cObject && klass != rb_cObject) {
3819 if (!recurse)
break;
3833 return rb_const_defined_0(klass,
id, TRUE, TRUE, FALSE);
3839 return rb_const_defined_0(klass,
id, FALSE, TRUE, FALSE);
3845 return rb_const_defined_0(klass,
id, TRUE, FALSE, FALSE);
3849rb_public_const_defined_from(
VALUE klass,
ID id)
3851 return rb_const_defined_0(klass,
id, TRUE, TRUE, TRUE);
3855check_before_mod_set(
VALUE klass,
ID id,
VALUE val,
const char *dest)
3857 rb_check_frozen(klass);
3860static void set_namespace_path(
VALUE named_namespace,
VALUE name);
3862static enum rb_id_table_iterator_result
3863set_namespace_path_i(
ID id,
VALUE v,
void *payload)
3865 rb_const_entry_t *ce = (rb_const_entry_t *)v;
3866 VALUE value = ce->value;
3869 return ID_TABLE_CONTINUE;
3872 bool has_permanent_classpath;
3873 classname(value, &has_permanent_classpath);
3874 if (has_permanent_classpath) {
3875 return ID_TABLE_CONTINUE;
3877 set_namespace_path(value, build_const_path(parental_path,
id));
3879 if (!RCLASS_PERMANENT_CLASSPATH_P(value)) {
3880 RCLASS_WRITE_CLASSPATH(value, 0,
false);
3883 return ID_TABLE_CONTINUE;
3892set_namespace_path(
VALUE named_namespace,
VALUE namespace_path)
3894 struct rb_id_table *const_table = RCLASS_CONST_TBL(named_namespace);
3895 RB_OBJ_SET_SHAREABLE(namespace_path);
3898 RCLASS_WRITE_CLASSPATH(named_namespace, namespace_path,
true);
3901 rb_id_table_foreach(const_table, set_namespace_path_i, &namespace_path);
3907const_added(
VALUE klass,
ID const_name)
3909 if (GET_VM()->running) {
3911 rb_funcallv(klass, idConst_added, 1, &name);
3918 rb_const_entry_t *ce;
3921 rb_raise(
rb_eTypeError,
"no class/module to define constant %"PRIsVALUE
"",
3926 rb_raise(rb_eRactorIsolationError,
"can not set constants with non-shareable objects by non-main Ractors");
3929 check_before_mod_set(klass,
id, val,
"constant");
3932 struct rb_id_table *tbl = RCLASS_WRITABLE_CONST_TBL(klass);
3934 tbl = rb_id_table_create(0);
3935 RCLASS_WRITE_CONST_TBL(klass, tbl,
false);
3937 ce =
ZALLOC(rb_const_entry_t);
3938 rb_id_table_insert(tbl,
id, (
VALUE)ce);
3939 setup_const_entry(ce, klass, val, CONST_PUBLIC);
3943 .module = klass, .name = id,
3944 .value = val, .flag = CONST_PUBLIC,
3947 ac.file = rb_source_location(&ac.line);
3948 const_tbl_update(&ac,
false);
3956 if (rb_cObject && rb_namespace_p(val)) {
3957 bool val_path_permanent;
3958 VALUE val_path = classname(val, &val_path_permanent);
3959 if (
NIL_P(val_path) || !val_path_permanent) {
3960 if (klass == rb_cObject) {
3961 set_namespace_path(val, rb_id2str(
id));
3964 bool parental_path_permanent;
3965 VALUE parental_path = classname(klass, &parental_path_permanent);
3966 if (
NIL_P(parental_path)) {
3968 parental_path = rb_tmp_class_path(klass, &throwaway, make_temporary_path);
3970 if (parental_path_permanent && !val_path_permanent) {
3971 set_namespace_path(val, build_const_path(parental_path,
id));
3973 else if (!parental_path_permanent &&
NIL_P(val_path)) {
3974 VALUE path = build_const_path(parental_path,
id);
3975 RCLASS_SET_CLASSPATH(val, path,
false);
3985 const_set(klass,
id, val);
3986 const_added(klass,
id);
3990autoload_const_value_for_named_constant(
VALUE module,
ID name,
struct autoload_const **autoload_const_pointer)
3993 if (!autoload_const_value)
return Qfalse;
4000 return autoload_const_value;
4010 VALUE klass = ac->module;
4011 VALUE val = ac->value;
4013 struct rb_id_table *tbl = RCLASS_CONST_TBL(klass);
4014 rb_const_flag_t visibility = ac->flag;
4015 rb_const_entry_t *ce;
4017 if (rb_id_table_lookup(tbl,
id, &value)) {
4018 ce = (rb_const_entry_t *)value;
4019 if (UNDEF_P(ce->value)) {
4020 RUBY_ASSERT_CRITICAL_SECTION_ENTER();
4021 VALUE file = ac->file;
4022 int line = ac->line;
4023 VALUE autoload_const_value = autoload_const_value_for_named_constant(klass,
id, &ac);
4025 if (!autoload_force && autoload_const_value) {
4029 RB_OBJ_WRITE(autoload_const_value, &ac->file, rb_source_location(&ac->line));
4033 autoload_delete(klass,
id);
4034 ce->flag = visibility;
4039 RUBY_ASSERT_CRITICAL_SECTION_LEAVE();
4043 VALUE name = QUOTE_ID(
id);
4044 visibility = ce->flag;
4045 if (klass == rb_cObject)
4046 rb_warn(
"already initialized constant %"PRIsVALUE
"", name);
4048 rb_warn(
"already initialized constant %"PRIsVALUE
"::%"PRIsVALUE
"",
4050 if (!
NIL_P(ce->file) && ce->line) {
4051 rb_compile_warn(RSTRING_PTR(ce->file), ce->line,
4052 "previous definition of %"PRIsVALUE
" was here", name);
4056 setup_const_entry(ce, klass, val, visibility);
4059 tbl = RCLASS_WRITABLE_CONST_TBL(klass);
4062 ce =
ZALLOC(rb_const_entry_t);
4063 rb_id_table_insert(tbl,
id, (
VALUE)ce);
4064 setup_const_entry(ce, klass, val, visibility);
4069setup_const_entry(rb_const_entry_t *ce,
VALUE klass,
VALUE val,
4070 rb_const_flag_t visibility)
4072 ce->flag = visibility;
4074 RB_OBJ_WRITE(klass, &ce->file, rb_source_location(&ce->line));
4080 ID id = rb_intern(name);
4083 rb_warn(
"rb_define_const: invalid name '%s' for constant", name);
4086 rb_vm_register_global_object(val);
4094 rb_define_const(rb_cObject, name, val);
4098set_const_visibility(
VALUE mod,
int argc,
const VALUE *argv,
4099 rb_const_flag_t flag, rb_const_flag_t mask)
4102 rb_const_entry_t *ce;
4107 rb_warning(
"%"PRIsVALUE
" with no argument is just ignored",
4112 for (i = 0; i < argc; i++) {
4114 VALUE val = argv[i];
4117 undefined_constant(mod, val);
4119 if ((ce = rb_const_lookup(mod,
id))) {
4122 if (UNDEF_P(ce->value)) {
4123 if (autoload_const_value_for_named_constant(mod,
id, &ac)) {
4131 undefined_constant(mod,
ID2SYM(
id));
4139 rb_const_entry_t *ce;
4141 long len = strlen(name);
4145 undefined_constant(mod, rb_fstring_new(name,
len));
4147 if (!(ce = rb_const_lookup(mod,
id))) {
4148 undefined_constant(mod,
ID2SYM(
id));
4150 ce->flag |= CONST_DEPRECATED;
4161rb_mod_private_constant(
int argc,
const VALUE *argv,
VALUE obj)
4163 set_const_visibility(obj, argc, argv, CONST_PRIVATE, CONST_VISIBILITY_MASK);
4175rb_mod_public_constant(
int argc,
const VALUE *argv,
VALUE obj)
4177 set_const_visibility(obj, argc, argv, CONST_PUBLIC, CONST_VISIBILITY_MASK);
4201rb_mod_deprecate_constant(
int argc,
const VALUE *argv,
VALUE obj)
4203 set_const_visibility(obj, argc, argv, CONST_DEPRECATED, CONST_DEPRECATED);
4208original_module(
VALUE c)
4216cvar_lookup_at(
VALUE klass,
ID id, st_data_t *v)
4219 if (RICLASS_IS_ORIGIN_P(klass)) {
4224 klass =
RBASIC(klass)->klass;
4229 if (UNDEF_P(n))
return 0;
4236cvar_front_klass(
VALUE klass)
4238 if (RCLASS_SINGLETON_P(klass)) {
4239 VALUE obj = RCLASS_ATTACHED_OBJECT(klass);
4240 if (rb_namespace_p(obj)) {
4250 if (front && target != front) {
4251 if (original_module(front) != original_module(target)) {
4253 "class variable % "PRIsVALUE
" of %"PRIsVALUE
" is overtaken by %"PRIsVALUE
"",
4258 rb_ivar_delete(front,
id,
Qundef);
4263#define CVAR_FOREACH_ANCESTORS(klass, v, r) \
4264 for (klass = cvar_front_klass(klass); klass; klass = RCLASS_SUPER(klass)) { \
4265 if (cvar_lookup_at(klass, id, (v))) { \
4270#define CVAR_LOOKUP(v,r) do {\
4271 CVAR_ACCESSOR_SHOULD_BE_MAIN_RACTOR(klass, id); \
4272 if (cvar_lookup_at(klass, id, (v))) {r;}\
4273 CVAR_FOREACH_ANCESTORS(klass, v, r);\
4291check_for_cvar_table(
VALUE subclass,
VALUE key)
4296 RB_DEBUG_COUNTER_INC(cvar_class_invalidate);
4297 ruby_vm_global_cvar_state++;
4301 rb_class_foreach_subclass(subclass, check_for_cvar_table, key);
4307 VALUE tmp, front = 0, target = 0;
4310 CVAR_LOOKUP(0, {
if (!front) front = klass; target = klass;});
4312 cvar_overtaken(front, target,
id);
4319 target =
RBASIC(target)->klass;
4321 check_before_mod_set(target,
id, val,
"class variable");
4323 bool new_cvar = rb_class_ivar_set(target,
id, val);
4325 VALUE cvc_tbl = RCLASS_WRITABLE_CVC_TBL(target);
4330 if (!cvc_tbl || !rb_marked_id_table_lookup(cvc_tbl,
id, &ent_data)) {
4334 ent->global_cvar_state = GET_GLOBAL_CVAR_STATE();
4336 VALUE new_cvc_tbl = cvc_tbl;
4338 new_cvc_tbl = rb_marked_id_table_new(2);
4340 else if (rb_multi_ractor_p()) {
4341 new_cvc_tbl = rb_marked_id_table_dup(cvc_tbl);
4344 rb_marked_id_table_insert(new_cvc_tbl,
id, (
VALUE)ent);
4345 if (new_cvc_tbl != cvc_tbl) {
4346 RCLASS_WRITE_CVC_TBL(target, new_cvc_tbl);
4348 RB_DEBUG_COUNTER_INC(cvar_inline_miss);
4351 ent = (
void *)ent_data;
4352 ent->global_cvar_state = GET_GLOBAL_CVAR_STATE();
4360 if (RCLASS_SUBCLASSES_FIRST(target)) {
4361 rb_class_foreach_subclass(target, check_for_cvar_table,
id);
4373 value = find_cvar(klass, front, &target,
id);
4375 rb_name_err_raise(
"uninitialized class variable %1$s in %2$s",
4378 cvar_overtaken(*front, target,
id);
4379 return (
VALUE)value;
4392 if (!klass)
return Qfalse;
4393 CVAR_LOOKUP(0,
return Qtrue);
4398cv_intern(
VALUE klass,
const char *name)
4400 ID id = rb_intern(name);
4402 rb_name_err_raise(
"wrong class variable name %1$s",
4411 ID id = cv_intern(klass, name);
4418 ID id = cv_intern(klass, name);
4429cv_i(
ID key,
VALUE v, st_data_t a)
4431 st_table *tbl = (st_table *)a;
4434 st_update(tbl, (st_data_t)key, cv_i_update, 0);
4440mod_cvar_at(
VALUE mod,
void *data)
4442 st_table *tbl = data;
4444 tbl = st_init_numtable();
4446 mod = original_module(mod);
4453mod_cvar_of(
VALUE mod,
void *data)
4456 if (RCLASS_SINGLETON_P(mod)) {
4457 if (rb_namespace_p(RCLASS_ATTACHED_OBJECT(mod))) {
4458 data = mod_cvar_at(tmp, data);
4459 tmp = cvar_front_klass(tmp);
4463 data = mod_cvar_at(tmp, data);
4471cv_list_i(st_data_t key, st_data_t value,
VALUE ary)
4479cvar_list(
void *data)
4481 st_table *tbl = data;
4515 bool inherit =
true;
4520 tbl = mod_cvar_of(mod, 0);
4523 tbl = mod_cvar_at(mod, 0);
4525 return cvar_list(tbl);
4550 const ID id = id_for_var_message(mod, name,
class,
"wrong class variable name %1$s");
4556 rb_check_frozen(mod);
4557 val = rb_ivar_delete(mod,
id,
Qundef);
4558 if (!UNDEF_P(val)) {
4562 rb_name_err_raise(
"cannot remove %1$s for %2$s", mod,
ID2SYM(
id));
4565 rb_name_err_raise(
"class variable %1$s not defined for %2$s",
4584 ID id = rb_intern(name);
4590class_fields_ivar_set(
VALUE klass,
VALUE fields_obj,
ID id,
VALUE val,
bool concurrent,
VALUE *new_fields_obj,
bool *new_ivar_out)
4592 const VALUE original_fields_obj = fields_obj;
4593 fields_obj = original_fields_obj ? original_fields_obj : rb_imemo_fields_new(klass, 1,
true);
4595 shape_id_t current_shape_id = RBASIC_SHAPE_ID(fields_obj);
4596 shape_id_t next_shape_id = current_shape_id;
4597 if (UNLIKELY(rb_shape_too_complex_p(current_shape_id))) {
4602 next_shape_id = generic_shape_ivar(fields_obj,
id, &new_ivar);
4604 if (UNLIKELY(rb_shape_too_complex_p(next_shape_id))) {
4605 fields_obj = imemo_fields_complex_from_obj(klass, fields_obj, next_shape_id);
4609 attr_index_t index = RSHAPE_INDEX(next_shape_id);
4611 if (index >= RSHAPE_CAPACITY(current_shape_id)) {
4614 fields_obj = imemo_fields_copy_capa(klass, fields_obj, RSHAPE_CAPACITY(next_shape_id));
4618 VALUE *fields = rb_imemo_fields_ptr(fields_obj);
4620 if (concurrent && original_fields_obj == fields_obj) {
4626 RB_OBJ_ATOMIC_WRITE(fields_obj, &fields[index], val);
4633 RBASIC_SET_SHAPE_ID(fields_obj, next_shape_id);
4636 *new_fields_obj = fields_obj;
4637 *new_ivar_out = new_ivar;
4642 if (concurrent && fields_obj == original_fields_obj) {
4646 fields_obj = rb_imemo_fields_clone(fields_obj);
4649 st_table *table = rb_imemo_fields_complex_tbl(fields_obj);
4650 new_ivar = !st_insert(table, (st_data_t)
id, (st_data_t)val);
4653 if (fields_obj != original_fields_obj) {
4654 RBASIC_SET_SHAPE_ID(fields_obj, next_shape_id);
4658 *new_fields_obj = fields_obj;
4659 *new_ivar_out = new_ivar;
4660 return ATTR_INDEX_NOT_SET;
4664class_ivar_set(
VALUE obj,
ID id,
VALUE val,
bool *new_ivar)
4666 rb_class_ensure_writable(obj);
4668 const VALUE original_fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(obj);
4669 VALUE new_fields_obj = 0;
4671 attr_index_t index = class_fields_ivar_set(obj, original_fields_obj,
id, val, rb_multi_ractor_p(), &new_fields_obj, new_ivar);
4673 if (new_fields_obj != original_fields_obj) {
4674 RCLASS_WRITABLE_SET_FIELDS_OBJ(obj, new_fields_obj);
4680 RBASIC_SET_SHAPE_ID(obj, RBASIC_SHAPE_ID(new_fields_obj));
4688 rb_check_frozen(obj);
4691 class_ivar_set(obj,
id, val, &new_ivar);
4700 RUBY_ASSERT(RSHAPE_TYPE_P(RBASIC_SHAPE_ID(dst), SHAPE_ROOT));
4702 VALUE fields_obj = RCLASS_WRITABLE_FIELDS_OBJ(src);
4704 RCLASS_WRITABLE_SET_FIELDS_OBJ(dst, rb_imemo_fields_clone(fields_obj));
4705 RBASIC_SET_SHAPE_ID(dst, RBASIC_SHAPE_ID(src));
4709static rb_const_entry_t *
4716 r = rb_id_table_lookup(tbl,
id, &val);
4719 if (r)
return (rb_const_entry_t *)val;
4725rb_const_lookup(
VALUE klass,
ID id)
4727 return const_lookup(RCLASS_CONST_TBL(klass),
id);
#define RUBY_ASSERT(...)
Asserts that the given expression is truthy if and only if RUBY_DEBUG is truthy.
#define RUBY_EXTERN
Declaration of externally visible global variables.
static VALUE RB_OBJ_FROZEN_RAW(VALUE obj)
This is an implementation detail of RB_OBJ_FROZEN().
static bool RB_FL_ABLE(VALUE obj)
Checks if the object is flaggable.
static void RB_FL_SET_RAW(VALUE obj, VALUE flags)
This is an implementation detail of RB_FL_SET().
void rb_obj_freeze_inline(VALUE obj)
Prevents further modifications to the given object.
static void RB_FL_UNSET_RAW(VALUE obj, VALUE flags)
This is an implementation detail of RB_FL_UNSET().
@ RUBY_FL_FREEZE
This flag has something to do with data immutability.
void rb_class_modify_check(VALUE klass)
Asserts that klass is not a frozen class.
void rb_freeze_singleton_class(VALUE x)
This is an implementation detail of RB_OBJ_FREEZE().
int rb_scan_args(int argc, const VALUE *argv, const char *fmt,...)
Retrieves argument from argc and argv to given VALUE references according to the format string.
#define rb_str_new2
Old name of rb_str_new_cstr.
#define TYPE(_)
Old name of rb_type.
#define FL_UNSET_RAW
Old name of RB_FL_UNSET_RAW.
#define FL_USER3
Old name of RUBY_FL_USER3.
#define REALLOC_N
Old name of RB_REALLOC_N.
#define ALLOC
Old name of RB_ALLOC.
#define T_STRING
Old name of RUBY_T_STRING.
#define xfree
Old name of ruby_xfree.
#define Qundef
Old name of RUBY_Qundef.
#define rb_str_cat2
Old name of rb_str_cat_cstr.
#define UNREACHABLE
Old name of RBIMPL_UNREACHABLE.
#define T_IMEMO
Old name of RUBY_T_IMEMO.
#define ID2SYM
Old name of RB_ID2SYM.
#define SPECIAL_CONST_P
Old name of RB_SPECIAL_CONST_P.
#define T_STRUCT
Old name of RUBY_T_STRUCT.
#define OBJ_FREEZE
Old name of RB_OBJ_FREEZE.
#define UNREACHABLE_RETURN
Old name of RBIMPL_UNREACHABLE_RETURN.
#define T_DATA
Old name of RUBY_T_DATA.
#define ZALLOC
Old name of RB_ZALLOC.
#define CLASS_OF
Old name of rb_class_of.
#define T_MODULE
Old name of RUBY_T_MODULE.
#define T_ICLASS
Old name of RUBY_T_ICLASS.
#define ALLOC_N
Old name of RB_ALLOC_N.
#define FL_TEST_RAW
Old name of RB_FL_TEST_RAW.
#define rb_ary_new3
Old name of rb_ary_new_from_args.
#define FL_USER2
Old name of RUBY_FL_USER2.
#define Qtrue
Old name of RUBY_Qtrue.
#define INT2NUM
Old name of RB_INT2NUM.
#define Qnil
Old name of RUBY_Qnil.
#define Qfalse
Old name of RUBY_Qfalse.
#define T_OBJECT
Old name of RUBY_T_OBJECT.
#define NIL_P
Old name of RB_NIL_P.
#define ALLOCV_N
Old name of RB_ALLOCV_N.
#define T_CLASS
Old name of RUBY_T_CLASS.
#define BUILTIN_TYPE
Old name of RB_BUILTIN_TYPE.
#define rb_ary_new2
Old name of rb_ary_new_capa.
#define FL_SET_RAW
Old name of RB_FL_SET_RAW.
#define ALLOCV_END
Old name of RB_ALLOCV_END.
void rb_category_warn(rb_warning_category_t category, const char *fmt,...)
Identical to rb_category_warning(), except it reports unless $VERBOSE is nil.
void rb_name_error(ID id, const char *fmt,...)
Raises an instance of rb_eNameError.
VALUE rb_eTypeError
TypeError exception.
void rb_name_error_str(VALUE str, const char *fmt,...)
Identical to rb_name_error(), except it takes a VALUE instead of ID.
VALUE rb_eNameError
NameError exception.
VALUE rb_eRuntimeError
RuntimeError exception.
void * rb_check_typeddata(VALUE obj, const rb_data_type_t *data_type)
Identical to rb_typeddata_is_kind_of(), except it raises exceptions instead of returning false.
void rb_warn(const char *fmt,...)
Identical to rb_warning(), except it reports unless $VERBOSE is nil.
void rb_warning(const char *fmt,...)
Issues a warning.
@ RB_WARN_CATEGORY_DEPRECATED
Warning is for deprecated features.
VALUE rb_obj_hide(VALUE obj)
Make the object invisible from Ruby code.
VALUE rb_obj_class(VALUE obj)
Queries the class of an object.
VALUE rb_cModule
Module class.
VALUE rb_class_real(VALUE klass)
Finds a "real" class.
size_t rb_obj_embedded_size(uint32_t fields_count)
Internal header for Object.
#define RB_OBJ_WRITTEN(old, oldv, young)
Identical to RB_OBJ_WRITE(), except it doesn't write any values, but only a WB declaration.
#define RB_OBJ_WRITE(old, slot, young)
Declaration of a "back" pointer.
rb_encoding * rb_usascii_encoding(void)
Queries the encoding that represents US-ASCII.
ID rb_check_id_cstr(const char *ptr, long len, rb_encoding *enc)
Identical to rb_check_id(), except it takes a pointer to a memory region instead of Ruby's string.
VALUE rb_funcall(VALUE recv, ID mid, int n,...)
Calls a method.
VALUE rb_ary_new(void)
Allocates a new, empty array.
VALUE rb_ary_hidden_new(long capa)
Allocates a hidden (no class) empty array.
VALUE rb_ary_push(VALUE ary, VALUE elem)
Special case of rb_ary_cat() that it adds only one element.
VALUE rb_assoc_new(VALUE car, VALUE cdr)
Identical to rb_ary_new_from_values(), except it expects exactly two parameters.
static int rb_check_arity(int argc, int min, int max)
Ensures that the passed integer is in the passed range.
ID rb_frame_callee(void)
Identical to rb_frame_this_func(), except it returns the named used to call the method.
#define st_foreach_safe
Just another name of rb_st_foreach_safe.
int rb_feature_provided(const char *feature, const char **loading)
Identical to rb_provided(), except it additionally returns the "canonical" name of the loaded feature...
VALUE rb_backref_get(void)
Queries the last match, or Regexp.last_match, or the $~.
int rb_is_instance_id(ID id)
Classifies the given ID, then sees if it is an instance variable.
int rb_is_const_id(ID id)
Classifies the given ID, then sees if it is a constant.
int rb_is_class_id(ID id)
Classifies the given ID, then sees if it is a class variable.
VALUE rb_block_proc(void)
Constructs a Proc object from implicitly passed components.
VALUE rb_reg_nth_defined(int n, VALUE md)
Identical to rb_reg_nth_match(), except it just returns Boolean.
VALUE rb_str_append(VALUE dst, VALUE src)
Identical to rb_str_buf_append(), except it converts the right hand side before concatenating.
VALUE rb_str_subseq(VALUE str, long beg, long len)
Identical to rb_str_substr(), except the numbers are interpreted as byte offsets instead of character...
VALUE rb_str_new_frozen(VALUE str)
Creates a frozen copy of the string, if necessary.
VALUE rb_str_dup(VALUE str)
Duplicates a string.
#define rb_str_new_cstr(str)
Identical to rb_str_new, except it assumes the passed pointer is a pointer to a C string.
VALUE rb_str_intern(VALUE str)
Identical to rb_to_symbol(), except it assumes the receiver being an instance of RString.
VALUE rb_mutex_new(void)
Creates a mutex.
VALUE rb_mutex_synchronize(VALUE mutex, VALUE(*func)(VALUE arg), VALUE arg)
Obtains the lock, runs the passed function, and releases the lock when it completes.
VALUE rb_exec_recursive_paired(VALUE(*f)(VALUE g, VALUE h, int r), VALUE g, VALUE p, VALUE h)
Identical to rb_exec_recursive(), except it checks for the recursion on the ordered pair of { g,...
VALUE rb_mod_remove_cvar(VALUE mod, VALUE name)
Resembles Module#remove_class_variable.
VALUE rb_obj_instance_variables(VALUE obj)
Resembles Object#instance_variables.
VALUE rb_f_untrace_var(int argc, const VALUE *argv)
Deletes the passed tracer from the passed global variable, or if omitted, deletes everything.
VALUE rb_const_get(VALUE space, ID name)
Identical to rb_const_defined(), except it returns the actual defined value.
VALUE rb_const_list(void *)
This is another mysterious API that comes with no documents at all.
VALUE rb_path2class(const char *path)
Resolves a Q::W::E::R-style path string to the actual class it points.
VALUE rb_autoload_p(VALUE space, ID name)
Queries if an autoload is defined at a point.
void rb_set_class_path(VALUE klass, VALUE space, const char *name)
Names a class.
VALUE rb_ivar_set(VALUE obj, ID name, VALUE val)
Identical to rb_iv_set(), except it accepts the name as an ID instead of a C string.
VALUE rb_mod_remove_const(VALUE space, VALUE name)
Resembles Module#remove_const.
VALUE rb_class_path_cached(VALUE mod)
Just another name of rb_mod_name.
VALUE rb_f_trace_var(int argc, const VALUE *argv)
Traces a global variable.
void rb_cvar_set(VALUE klass, ID name, VALUE val)
Assigns a value to a class variable.
VALUE rb_cvar_get(VALUE klass, ID name)
Obtains a value from a class variable.
VALUE rb_mod_constants(int argc, const VALUE *argv, VALUE recv)
Resembles Module#constants.
VALUE rb_cvar_find(VALUE klass, ID name, VALUE *front)
Identical to rb_cvar_get(), except it takes additional "front" pointer.
VALUE rb_path_to_class(VALUE path)
Identical to rb_path2class(), except it accepts the path as Ruby's string instead of C's.
VALUE rb_ivar_get(VALUE obj, ID name)
Identical to rb_iv_get(), except it accepts the name as an ID instead of a C string.
void rb_const_set(VALUE space, ID name, VALUE val)
Names a constant.
VALUE rb_autoload_load(VALUE space, ID name)
Kicks the autoload procedure as if it was "touched".
VALUE rb_mod_name(VALUE mod)
Queries the name of a module.
VALUE rb_class_name(VALUE obj)
Queries the name of the given object's class.
VALUE rb_const_get_at(VALUE space, ID name)
Identical to rb_const_defined_at(), except it returns the actual defined value.
void rb_set_class_path_string(VALUE klass, VALUE space, VALUE name)
Identical to rb_set_class_path(), except it accepts the name as Ruby's string instead of C's.
void rb_alias_variable(ID dst, ID src)
Aliases a global variable.
void rb_define_class_variable(VALUE, const char *, VALUE)
Just another name of rb_cv_set.
VALUE rb_obj_remove_instance_variable(VALUE obj, VALUE name)
Resembles Object#remove_instance_variable.
void * rb_mod_const_of(VALUE, void *)
This is a variant of rb_mod_const_at().
st_index_t rb_ivar_count(VALUE obj)
Number of instance variables defined on an object.
void * rb_mod_const_at(VALUE, void *)
This API is mysterious.
VALUE rb_const_remove(VALUE space, ID name)
Identical to rb_mod_remove_const(), except it takes the name as ID instead of VALUE.
VALUE rb_const_get_from(VALUE space, ID name)
Identical to rb_const_defined_at(), except it returns the actual defined value.
VALUE rb_ivar_defined(VALUE obj, ID name)
Queries if the instance variable is defined at the object.
VALUE rb_cv_get(VALUE klass, const char *name)
Identical to rb_cvar_get(), except it accepts C's string instead of ID.
int rb_const_defined_at(VALUE space, ID name)
Identical to rb_const_defined(), except it doesn't look for parent classes.
void rb_cv_set(VALUE klass, const char *name, VALUE val)
Identical to rb_cvar_set(), except it accepts C's string instead of ID.
VALUE rb_mod_class_variables(int argc, const VALUE *argv, VALUE recv)
Resembles Module#class_variables.
VALUE rb_f_global_variables(void)
Queries the list of global variables.
VALUE rb_cvar_defined(VALUE klass, ID name)
Queries if the given class has the given class variable.
VALUE rb_class_path(VALUE mod)
Identical to rb_mod_name(), except it returns #<Class: ...> style inspection for anonymous modules.
int rb_const_defined_from(VALUE space, ID name)
Identical to rb_const_defined(), except it returns false for private constants.
int rb_const_defined(VALUE space, ID name)
Queries if the constant is defined at the namespace.
void rb_free_generic_ivar(VALUE obj)
Frees the list of instance variables.
const char * rb_sourcefile(void)
Resembles __FILE__.
void rb_clear_constant_cache_for_id(ID id)
Clears the inline constant caches associated with a particular ID.
int rb_obj_respond_to(VALUE obj, ID mid, int private_p)
Identical to rb_respond_to(), except it additionally takes the visibility parameter.
static ID rb_intern_const(const char *str)
This is a "tiny optimisation" over rb_intern().
VALUE rb_id2sym(ID id)
Allocates an instance of rb_cSymbol that has the given id.
ID rb_check_id(volatile VALUE *namep)
Detects if the given name is already interned or not.
ID rb_to_id(VALUE str)
Identical to rb_intern_str(), except it tries to convert the parameter object to an instance of rb_cS...
rb_gvar_setter_t rb_gvar_var_setter
rb_gvar_marker_t rb_gvar_var_marker
void rb_define_global_const(const char *name, VALUE val)
Identical to rb_define_const(), except it defines that of "global", i.e.
VALUE rb_gv_get(const char *name)
Obtains a global variable.
void rb_define_variable(const char *name, VALUE *var)
"Shares" a global variable between Ruby and C.
void rb_gvar_marker_t(VALUE *var)
Type that represents a global variable marker function.
void rb_deprecate_constant(VALUE mod, const char *name)
Asserts that the given constant is deprecated.
void rb_gvar_setter_t(VALUE val, ID id, VALUE *data)
Type that represents a global variable setter function.
rb_gvar_setter_t rb_gvar_val_setter
This is the setter function that backs global variables defined from a ruby script.
rb_gvar_marker_t rb_gvar_undef_marker
void rb_define_readonly_variable(const char *name, const VALUE *var)
Identical to rb_define_variable(), except it does not allow Ruby programs to assign values to such gl...
rb_gvar_setter_t rb_gvar_readonly_setter
This function just raises rb_eNameError.
rb_gvar_getter_t rb_gvar_undef_getter
VALUE rb_gv_set(const char *name, VALUE val)
Assigns to a global variable.
rb_gvar_marker_t rb_gvar_val_marker
This is the setter function that backs global variables defined from a ruby script.
VALUE rb_gvar_getter_t(ID id, VALUE *data)
Type that represents a global variable getter function.
VALUE rb_iv_get(VALUE obj, const char *name)
Obtains an instance variable.
rb_gvar_setter_t rb_gvar_undef_setter
rb_gvar_getter_t rb_gvar_val_getter
This is the getter function that backs global variables defined from a ruby script.
VALUE rb_iv_set(VALUE obj, const char *name, VALUE val)
Assigns to an instance variable.
rb_gvar_getter_t rb_gvar_var_getter
int len
Length of the buffer.
static bool rb_ractor_shareable_p(VALUE obj)
Queries if multiple Ractors can share the passed object or not.
#define RB_OBJ_SHAREABLE_P(obj)
Queries if the passed object has previously classified as shareable or not.
#define MEMCPY(p1, p2, type, n)
Handy macro to call memcpy.
#define RB_GC_GUARD(v)
Prevents premature destruction of local objects.
#define MEMMOVE(p1, p2, type, n)
Handy macro to call memmove.
void rb_define_hooked_variable(const char *q, VALUE *w, type *e, void_type *r)
Define a function-backended global variable.
VALUE type(ANYARGS)
ANYARGS-ed function type.
int st_foreach(st_table *q, int_type *w, st_data_t e)
Iteration over the given table.
void rb_define_virtual_variable(const char *q, type *w, void_type *e)
Define a function-backended global variable.
void rb_ivar_foreach(VALUE q, int_type *w, VALUE e)
Iteration over each instance variable of the object.
VALUE rb_ensure(type *q, VALUE w, type *e, VALUE r)
An equivalent of ensure clause.
void rb_copy_generic_ivar(VALUE clone, VALUE obj)
Copies the list of instance variables.
#define RARRAY_LEN
Just another name of rb_array_len.
static VALUE RBASIC_CLASS(VALUE obj)
Queries the class of an object.
#define RBASIC(obj)
Convenient casting macro.
#define RCLASS_SUPER
Just another name of rb_class_get_superclass.
#define ROBJECT(obj)
Convenient casting macro.
static VALUE * ROBJECT_FIELDS(VALUE obj)
Queries the instance variables.
#define StringValue(v)
Ensures that the parameter object is a String.
static char * RSTRING_END(VALUE str)
Queries the end of the contents pointer of the string.
static bool RTYPEDDATA_P(VALUE obj)
Checks whether the passed object is RTypedData or RData.
#define RTYPEDDATA_DATA(v)
Convenient getter macro.
#define TypedData_Wrap_Struct(klass, data_type, sval)
Converts sval, a pointer to your struct, into a Ruby object.
struct rb_data_type_struct rb_data_type_t
This is the struct that holds necessary info for a struct.
#define RTYPEDDATA(obj)
Convenient casting macro.
#define TypedData_Make_Struct(klass, type, data_type, sval)
Identical to TypedData_Wrap_Struct, except it allocates a new data region internally instead of takin...
const char * rb_class2name(VALUE klass)
Queries the name of the passed class.
const char * rb_obj_classname(VALUE obj)
Queries the name of the class of the passed object.
#define RB_NO_KEYWORDS
Do not pass keywords.
static bool RB_SPECIAL_CONST_P(VALUE obj)
Checks if the given object is of enum ruby_special_consts.
#define RTEST
This is an old name of RB_TEST.
#define _(args)
This was a transition path from K&R to ANSI.
C99 shim for <stdbool.h>.
uintptr_t ID
Type that represents a Ruby identifier such as a variable name.
uintptr_t VALUE
Type that represents a Ruby object.
static enum ruby_value_type rb_type(VALUE obj)
Identical to RB_BUILTIN_TYPE(), except it can also accept special constants.
static enum ruby_value_type RB_BUILTIN_TYPE(VALUE obj)
Queries the type of the object.
static void Check_Type(VALUE v, enum ruby_value_type t)
Identical to RB_TYPE_P(), except it raises exceptions on predication failure.
static bool RB_TYPE_P(VALUE obj, enum ruby_value_type t)
Queries if the given object is of given type.