2 ** class.c - Class class
4 ** See Copyright Notice in mruby.h
9 #include <mruby/array.h>
10 #include <mruby/class.h>
11 #include <mruby/numeric.h>
12 #include <mruby/proc.h>
13 #include <mruby/string.h>
14 #include <mruby/variable.h>
15 #include <mruby/error.h>
16 #include <mruby/data.h>
17 #include <mruby/istruct.h>
19 KHASH_DEFINE(mt, mrb_sym, mrb_method_t, TRUE, kh_int_hash_func, kh_int_hash_equal)
22 mrb_gc_mark_mt(mrb_state *mrb, struct RClass *c)
25 khash_t(mt) *h = c->mt;
28 for (k = kh_begin(h); k != kh_end(h); k++) {
30 mrb_method_t m = kh_value(h, k);
32 if (MRB_METHOD_PROC_P(m)) {
33 struct RProc *p = MRB_METHOD_PROC(m);
34 mrb_gc_mark(mrb, (struct RBasic*)p);
41 mrb_gc_mark_mt_size(mrb_state *mrb, struct RClass *c)
43 khash_t(mt) *h = c->mt;
50 mrb_gc_free_mt(mrb_state *mrb, struct RClass *c)
52 kh_destroy(mt, mrb, c->mt);
56 mrb_class_name_class(mrb_state *mrb, struct RClass *outer, struct RClass *c, mrb_sym id)
59 mrb_sym nsym = mrb_intern_lit(mrb, "__classname__");
61 if (mrb_obj_iv_defined(mrb, (struct RObject*)c, nsym)) return;
62 if (outer == NULL || outer == mrb->object_class) {
63 name = mrb_symbol_value(id);
66 name = mrb_class_path(mrb, outer);
67 if (mrb_nil_p(name)) { /* unnamed outer class */
68 if (outer != mrb->object_class && outer != c) {
69 mrb_obj_iv_set(mrb, (struct RObject*)c, mrb_intern_lit(mrb, "__outer__"),
70 mrb_obj_value(outer));
74 mrb_str_cat_cstr(mrb, name, "::");
75 mrb_str_cat_cstr(mrb, name, mrb_sym2name(mrb, id));
77 mrb_obj_iv_set(mrb, (struct RObject*)c, nsym, name);
81 setup_class(mrb_state *mrb, struct RClass *outer, struct RClass *c, mrb_sym id)
83 mrb_class_name_class(mrb, outer, c, id);
84 mrb_obj_iv_set(mrb, (struct RObject*)outer, id, mrb_obj_value(c));
87 #define make_metaclass(mrb, c) prepare_singleton_class((mrb), (struct RBasic*)(c))
90 prepare_singleton_class(mrb_state *mrb, struct RBasic *o)
92 struct RClass *sc, *c;
94 if (o->c->tt == MRB_TT_SCLASS) return;
95 sc = (struct RClass*)mrb_obj_alloc(mrb, MRB_TT_SCLASS, mrb->class_class);
96 sc->flags |= MRB_FL_CLASS_IS_INHERITED;
97 sc->mt = kh_init(mt, mrb);
99 if (o->tt == MRB_TT_CLASS) {
100 c = (struct RClass*)o;
102 sc->super = mrb->class_class;
105 sc->super = c->super->c;
108 else if (o->tt == MRB_TT_SCLASS) {
109 c = (struct RClass*)o;
110 while (c->super->tt == MRB_TT_ICLASS)
112 make_metaclass(mrb, c->super);
113 sc->super = c->super->c;
117 prepare_singleton_class(mrb, (struct RBasic*)sc);
120 mrb_field_write_barrier(mrb, (struct RBasic*)o, (struct RBasic*)sc);
121 mrb_field_write_barrier(mrb, (struct RBasic*)sc, (struct RBasic*)o);
122 mrb_obj_iv_set(mrb, (struct RObject*)sc, mrb_intern_lit(mrb, "__attached__"), mrb_obj_value(o));
126 class_name_str(mrb_state *mrb, struct RClass* c)
128 mrb_value path = mrb_class_path(mrb, c);
129 if (mrb_nil_p(path)) {
130 path = c->tt == MRB_TT_MODULE ? mrb_str_new_lit(mrb, "#<Module:") :
131 mrb_str_new_lit(mrb, "#<Class:");
132 mrb_str_concat(mrb, path, mrb_ptr_to_str(mrb, c));
133 mrb_str_cat_lit(mrb, path, ">");
138 static struct RClass*
139 class_from_sym(mrb_state *mrb, struct RClass *klass, mrb_sym id)
141 mrb_value c = mrb_const_get(mrb, mrb_obj_value(klass), id);
143 mrb_check_type(mrb, c, MRB_TT_CLASS);
144 return mrb_class_ptr(c);
147 static struct RClass*
148 module_from_sym(mrb_state *mrb, struct RClass *klass, mrb_sym id)
150 mrb_value c = mrb_const_get(mrb, mrb_obj_value(klass), id);
152 mrb_check_type(mrb, c, MRB_TT_MODULE);
153 return mrb_class_ptr(c);
157 class_ptr_p(mrb_value obj)
159 switch (mrb_type(obj)) {
170 check_if_class_or_module(mrb_state *mrb, mrb_value obj)
172 if (!class_ptr_p(obj)) {
173 mrb_raisef(mrb, E_TYPE_ERROR, "%S is not a class/module", mrb_inspect(mrb, obj));
177 static struct RClass*
178 define_module(mrb_state *mrb, mrb_sym name, struct RClass *outer)
182 if (mrb_const_defined_at(mrb, mrb_obj_value(outer), name)) {
183 return module_from_sym(mrb, outer, name);
185 m = mrb_module_new(mrb);
186 setup_class(mrb, outer, m, name);
191 MRB_API struct RClass*
192 mrb_define_module_id(mrb_state *mrb, mrb_sym name)
194 return define_module(mrb, name, mrb->object_class);
197 MRB_API struct RClass*
198 mrb_define_module(mrb_state *mrb, const char *name)
200 return define_module(mrb, mrb_intern_cstr(mrb, name), mrb->object_class);
203 MRB_API struct RClass*
204 mrb_vm_define_module(mrb_state *mrb, mrb_value outer, mrb_sym id)
206 check_if_class_or_module(mrb, outer);
207 if (mrb_const_defined_at(mrb, outer, id)) {
208 mrb_value old = mrb_const_get(mrb, outer, id);
210 if (mrb_type(old) != MRB_TT_MODULE) {
211 mrb_raisef(mrb, E_TYPE_ERROR, "%S is not a module", mrb_inspect(mrb, old));
213 return mrb_class_ptr(old);
215 return define_module(mrb, id, mrb_class_ptr(outer));
218 MRB_API struct RClass*
219 mrb_define_module_under(mrb_state *mrb, struct RClass *outer, const char *name)
221 mrb_sym id = mrb_intern_cstr(mrb, name);
222 struct RClass * c = define_module(mrb, id, outer);
224 setup_class(mrb, outer, c, id);
228 static struct RClass*
229 find_origin(struct RClass *c)
235 static struct RClass*
236 define_class(mrb_state *mrb, mrb_sym name, struct RClass *super, struct RClass *outer)
240 if (mrb_const_defined_at(mrb, mrb_obj_value(outer), name)) {
241 c = class_from_sym(mrb, outer, name);
243 if (super && mrb_class_real(c->super) != super) {
244 mrb_raisef(mrb, E_TYPE_ERROR, "superclass mismatch for Class %S (%S not %S)",
245 mrb_sym2str(mrb, name),
246 mrb_obj_value(c->super), mrb_obj_value(super));
251 c = mrb_class_new(mrb, super);
252 setup_class(mrb, outer, c, name);
257 MRB_API struct RClass*
258 mrb_define_class_id(mrb_state *mrb, mrb_sym name, struct RClass *super)
261 mrb_warn(mrb, "no super class for '%S', Object assumed", mrb_sym2str(mrb, name));
263 return define_class(mrb, name, super, mrb->object_class);
266 MRB_API struct RClass*
267 mrb_define_class(mrb_state *mrb, const char *name, struct RClass *super)
269 return mrb_define_class_id(mrb, mrb_intern_cstr(mrb, name), super);
272 static mrb_value mrb_bob_init(mrb_state *mrb, mrb_value);
273 #ifdef MRB_METHOD_CACHE
274 static void mc_clear_all(mrb_state *mrb);
275 static void mc_clear_by_class(mrb_state *mrb, struct RClass*);
276 static void mc_clear_by_id(mrb_state *mrb, struct RClass*, mrb_sym);
278 #define mc_clear_all(mrb)
279 #define mc_clear_by_class(mrb,c)
280 #define mc_clear_by_id(mrb,c,s)
284 mrb_class_inherited(mrb_state *mrb, struct RClass *super, struct RClass *klass)
290 super = mrb->object_class;
291 super->flags |= MRB_FL_CLASS_IS_INHERITED;
292 s = mrb_obj_value(super);
293 mc_clear_by_class(mrb, klass);
294 mid = mrb_intern_lit(mrb, "inherited");
295 if (!mrb_func_basic_p(mrb, s, mid, mrb_bob_init)) {
296 mrb_value c = mrb_obj_value(klass);
297 mrb_funcall_argv(mrb, s, mid, 1, &c);
301 MRB_API struct RClass*
302 mrb_vm_define_class(mrb_state *mrb, mrb_value outer, mrb_value super, mrb_sym id)
307 if (!mrb_nil_p(super)) {
308 if (mrb_type(super) != MRB_TT_CLASS) {
309 mrb_raisef(mrb, E_TYPE_ERROR, "superclass must be a Class (%S given)",
310 mrb_inspect(mrb, super));
312 s = mrb_class_ptr(super);
317 check_if_class_or_module(mrb, outer);
318 if (mrb_const_defined_at(mrb, outer, id)) {
319 mrb_value old = mrb_const_get(mrb, outer, id);
321 if (mrb_type(old) != MRB_TT_CLASS) {
322 mrb_raisef(mrb, E_TYPE_ERROR, "%S is not a class", mrb_inspect(mrb, old));
324 c = mrb_class_ptr(old);
326 /* check super class */
327 if (mrb_class_real(c->super) != s) {
328 mrb_raisef(mrb, E_TYPE_ERROR, "superclass mismatch for class %S", old);
333 c = define_class(mrb, id, s, mrb_class_ptr(outer));
334 mrb_class_inherited(mrb, mrb_class_real(c->super), c);
340 mrb_class_defined(mrb_state *mrb, const char *name)
342 mrb_value sym = mrb_check_intern_cstr(mrb, name);
343 if (mrb_nil_p(sym)) {
346 return mrb_const_defined(mrb, mrb_obj_value(mrb->object_class), mrb_symbol(sym));
350 mrb_class_defined_under(mrb_state *mrb, struct RClass *outer, const char *name)
352 mrb_value sym = mrb_check_intern_cstr(mrb, name);
353 if (mrb_nil_p(sym)) {
356 return mrb_const_defined_at(mrb, mrb_obj_value(outer), mrb_symbol(sym));
359 MRB_API struct RClass*
360 mrb_class_get_under(mrb_state *mrb, struct RClass *outer, const char *name)
362 return class_from_sym(mrb, outer, mrb_intern_cstr(mrb, name));
365 MRB_API struct RClass*
366 mrb_class_get(mrb_state *mrb, const char *name)
368 return mrb_class_get_under(mrb, mrb->object_class, name);
371 MRB_API struct RClass*
372 mrb_exc_get(mrb_state *mrb, const char *name)
374 struct RClass *exc, *e;
375 mrb_value c = mrb_const_get(mrb, mrb_obj_value(mrb->object_class),
376 mrb_intern_cstr(mrb, name));
378 if (mrb_type(c) != MRB_TT_CLASS) {
379 mrb_raise(mrb, mrb->eException_class, "exception corrupted");
381 exc = e = mrb_class_ptr(c);
384 if (e == mrb->eException_class)
388 return mrb->eException_class;
391 MRB_API struct RClass*
392 mrb_module_get_under(mrb_state *mrb, struct RClass *outer, const char *name)
394 return module_from_sym(mrb, outer, mrb_intern_cstr(mrb, name));
397 MRB_API struct RClass*
398 mrb_module_get(mrb_state *mrb, const char *name)
400 return mrb_module_get_under(mrb, mrb->object_class, name);
404 * Defines a class under the namespace of \a outer.
405 * \param outer a class which contains the new class.
406 * \param id name of the new class
407 * \param super a class from which the new class will derive.
408 * NULL means \c Object class.
409 * \return the created class
410 * \throw TypeError if the constant name \a name is already taken but
411 * the constant is not a \c Class.
412 * \throw NameError if the class is already defined but the class can not
413 * be reopened because its superclass is not \a super.
414 * \post top-level constant named \a name refers the returned class.
416 * \note if a class named \a name is already defined and its superclass is
417 * \a super, the function just returns the defined class.
419 MRB_API struct RClass*
420 mrb_define_class_under(mrb_state *mrb, struct RClass *outer, const char *name, struct RClass *super)
422 mrb_sym id = mrb_intern_cstr(mrb, name);
427 mrb_warn(mrb, "no super class for '%S::%S', Object assumed",
428 mrb_obj_value(outer), mrb_sym2str(mrb, id));
431 c = define_class(mrb, id, super, outer);
432 setup_class(mrb, outer, c, id);
437 mrb_define_method_raw(mrb_state *mrb, struct RClass *c, mrb_sym mid, mrb_method_t m)
444 if (MRB_FROZEN_P(c)) {
445 if (c->tt == MRB_TT_MODULE)
446 mrb_raise(mrb, E_FROZEN_ERROR, "can't modify frozen module");
448 mrb_raise(mrb, E_FROZEN_ERROR, "can't modify frozen class");
450 if (!h) h = c->mt = kh_init(mt, mrb);
451 k = kh_put(mt, mrb, h, mid);
453 if (MRB_METHOD_PROC_P(m) && !MRB_METHOD_UNDEF_P(m)) {
454 struct RProc *p = MRB_METHOD_PROC(m);
456 p->flags |= MRB_PROC_SCOPE;
458 mrb_field_write_barrier(mrb, (struct RBasic*)c, (struct RBasic*)p);
459 if (!MRB_PROC_ENV_P(p)) {
460 MRB_PROC_SET_TARGET_CLASS(p, c);
463 mc_clear_by_id(mrb, c, mid);
467 mrb_define_method_id(mrb_state *mrb, struct RClass *c, mrb_sym mid, mrb_func_t func, mrb_aspec aspec)
470 int ai = mrb_gc_arena_save(mrb);
472 MRB_METHOD_FROM_FUNC(m, func);
473 mrb_define_method_raw(mrb, c, mid, m);
474 mrb_gc_arena_restore(mrb, ai);
478 mrb_define_method(mrb_state *mrb, struct RClass *c, const char *name, mrb_func_t func, mrb_aspec aspec)
480 mrb_define_method_id(mrb, c, mrb_intern_cstr(mrb, name), func, aspec);
483 /* a function to raise NotImplementedError with current method name */
485 mrb_notimplement(mrb_state *mrb)
487 mrb_callinfo *ci = mrb->c->ci;
490 mrb_value str = mrb_sym2str(mrb, ci->mid);
491 mrb_raisef(mrb, E_NOTIMP_ERROR, "%S() function is unimplemented on this machine", str);
495 /* a function to be replacement of unimplemented method */
497 mrb_notimplement_m(mrb_state *mrb, mrb_value self)
499 mrb_notimplement(mrb);
501 return mrb_nil_value();
504 #define CHECK_TYPE(mrb, val, t, c) do { \
505 if (mrb_type(val) != (t)) {\
506 mrb_raisef(mrb, E_TYPE_ERROR, "expected %S", mrb_str_new_lit(mrb, c));\
511 to_str(mrb_state *mrb, mrb_value val)
513 CHECK_TYPE(mrb, val, MRB_TT_STRING, "String");
518 to_ary(mrb_state *mrb, mrb_value val)
520 CHECK_TYPE(mrb, val, MRB_TT_ARRAY, "Array");
525 to_hash(mrb_state *mrb, mrb_value val)
527 CHECK_TYPE(mrb, val, MRB_TT_HASH, "Hash");
531 #define to_sym(mrb, ss) mrb_obj_to_sym(mrb, ss)
534 mrb_get_argc(mrb_state *mrb)
536 mrb_int argc = mrb->c->ci->argc;
539 struct RArray *a = mrb_ary_ptr(mrb->c->stack[1]);
547 mrb_get_argv(mrb_state *mrb)
549 mrb_int argc = mrb->c->ci->argc;
550 mrb_value *array_argv;
552 struct RArray *a = mrb_ary_ptr(mrb->c->stack[1]);
554 array_argv = ARY_PTR(a);
563 retrieve arguments from mrb_state.
565 mrb_get_args(mrb, format, ...)
567 returns number of arguments parsed.
571 string mruby type C type note
572 ----------------------------------------------------------------------------------------------
573 o: Object [mrb_value]
574 C: class/module [mrb_value]
575 S: String [mrb_value] when ! follows, the value may be nil
576 A: Array [mrb_value] when ! follows, the value may be nil
577 H: Hash [mrb_value] when ! follows, the value may be nil
578 s: String [char*,mrb_int] Receive two arguments; s! gives (NULL,0) for nil
579 z: String [char*] NUL terminated string; z! gives NULL for nil
580 a: Array [mrb_value*,mrb_int] Receive two arguments; a! gives (NULL,0) for nil
583 b: Boolean [mrb_bool]
585 d: Data [void*,mrb_data_type const] 2nd argument will be used to check data type so it won't be modified
586 I: Inline struct [void*]
587 &: Block [mrb_value] &! raises exception if no block given
588 *: rest argument [mrb_value*,mrb_int] The rest of the arguments as an array; *! avoid copy of the stack
589 |: optional Following arguments are optional
590 ?: optional given [mrb_bool] true if preceding argument (optional) is given
593 mrb_get_args(mrb_state *mrb, const char *format, ...)
595 const char *fmt = format;
599 mrb_int argc = mrb_get_argc(mrb);
601 mrb_value *array_argv = mrb_get_argv(mrb);
602 mrb_bool opt = FALSE;
603 mrb_bool opt_skip = TRUE;
604 mrb_bool given = TRUE;
606 va_start(ap, format);
609 (array_argv ? array_argv : (mrb->c->stack + 1))
611 while ((c = *fmt++)) {
622 if (opt) opt_skip = FALSE;
632 while ((c = *format++)) {
634 case '|': case '*': case '&': case '?':
642 mrb_raise(mrb, E_ARGUMENT_ERROR, "wrong number of arguments");
653 p = va_arg(ap, mrb_value*);
664 p = va_arg(ap, mrb_value*);
669 if (!class_ptr_p(ss)) {
670 mrb_raisef(mrb, E_TYPE_ERROR, "%S is not class/module", ss);
681 p = va_arg(ap, mrb_value*);
682 if (*format == '!') {
684 if (i < argc && mrb_nil_p(ARGV[arg_i])) {
691 *p = to_str(mrb, ARGV[arg_i++]);
700 p = va_arg(ap, mrb_value*);
701 if (*format == '!') {
703 if (i < argc && mrb_nil_p(ARGV[arg_i])) {
710 *p = to_ary(mrb, ARGV[arg_i++]);
719 p = va_arg(ap, mrb_value*);
720 if (*format == '!') {
722 if (i < argc && mrb_nil_p(ARGV[arg_i])) {
729 *p = to_hash(mrb, ARGV[arg_i++]);
740 ps = va_arg(ap, char**);
741 pl = va_arg(ap, mrb_int*);
742 if (*format == '!') {
744 if (i < argc && mrb_nil_p(ARGV[arg_i])) {
752 ss = to_str(mrb, ARGV[arg_i++]);
753 *ps = RSTRING_PTR(ss);
754 *pl = RSTRING_LEN(ss);
764 ps = va_arg(ap, const char**);
765 if (*format == '!') {
767 if (i < argc && mrb_nil_p(ARGV[arg_i])) {
774 ss = to_str(mrb, ARGV[arg_i++]);
775 *ps = mrb_string_value_cstr(mrb, &ss);
787 pb = va_arg(ap, mrb_value**);
788 pl = va_arg(ap, mrb_int*);
789 if (*format == '!') {
791 if (i < argc && mrb_nil_p(ARGV[arg_i])) {
799 aa = to_ary(mrb, ARGV[arg_i++]);
812 p = va_arg(ap, void**);
815 if (mrb_type(ss) != MRB_TT_ISTRUCT)
817 mrb_raisef(mrb, E_TYPE_ERROR, "%S is not inline struct", ss);
819 *p = mrb_istruct_ptr(ss);
825 #ifndef MRB_WITHOUT_FLOAT
830 p = va_arg(ap, mrb_float*);
832 *p = mrb_to_flo(mrb, ARGV[arg_i]);
843 p = va_arg(ap, mrb_int*);
845 switch (mrb_type(ARGV[arg_i])) {
847 *p = mrb_fixnum(ARGV[arg_i]);
849 #ifndef MRB_WITHOUT_FLOAT
852 mrb_float f = mrb_float(ARGV[arg_i]);
854 if (!FIXABLE_FLOAT(f)) {
855 mrb_raise(mrb, E_RANGE_ERROR, "float too big for int");
862 mrb_raise(mrb, E_TYPE_ERROR, "no implicit conversion of String into Integer");
865 *p = mrb_fixnum(mrb_Integer(mrb, ARGV[arg_i]));
875 mrb_bool *boolp = va_arg(ap, mrb_bool*);
878 mrb_value b = ARGV[arg_i++];
879 *boolp = mrb_test(b);
888 symp = va_arg(ap, mrb_sym*);
893 *symp = to_sym(mrb, ss);
901 struct mrb_data_type const* type;
903 datap = va_arg(ap, void**);
904 type = va_arg(ap, struct mrb_data_type const*);
905 if (*format == '!') {
907 if (i < argc && mrb_nil_p(ARGV[arg_i])) {
914 *datap = mrb_data_get_ptr(mrb, ARGV[arg_i++], type);
924 p = va_arg(ap, mrb_value*);
925 if (mrb->c->ci->argc < 0) {
926 bp = mrb->c->stack + 2;
929 bp = mrb->c->stack + mrb->c->ci->argc + 1;
931 if (*format == '!') {
933 if (mrb_nil_p(*bp)) {
934 mrb_raise(mrb, E_ARGUMENT_ERROR, "no block given");
941 if (opt_skip && i == argc) return argc;
948 p = va_arg(ap, mrb_bool*);
957 mrb_bool nocopy = array_argv ? TRUE : FALSE;
959 if (*format == '!') {
963 var = va_arg(ap, mrb_value**);
964 pl = va_arg(ap, mrb_int*);
972 mrb_value args = mrb_ary_new_from_values(mrb, *pl, ARGV+arg_i);
973 RARRAY(args)->c = NULL;
974 *var = RARRAY_PTR(args);
987 mrb_raisef(mrb, E_ARGUMENT_ERROR, "invalid argument specifier %S", mrb_str_new(mrb, &c, 1));
994 if (!c && argc > i) {
995 mrb_raise(mrb, E_ARGUMENT_ERROR, "wrong number of arguments");
1001 static struct RClass*
1002 boot_defclass(mrb_state *mrb, struct RClass *super)
1006 c = (struct RClass*)mrb_obj_alloc(mrb, MRB_TT_CLASS, mrb->class_class);
1009 mrb_field_write_barrier(mrb, (struct RBasic*)c, (struct RBasic*)super);
1012 c->super = mrb->object_class;
1014 c->mt = kh_init(mt, mrb);
1019 boot_initmod(mrb_state *mrb, struct RClass *mod)
1022 mod->mt = kh_init(mt, mrb);
1026 static struct RClass*
1027 include_class_new(mrb_state *mrb, struct RClass *m, struct RClass *super)
1029 struct RClass *ic = (struct RClass*)mrb_obj_alloc(mrb, MRB_TT_ICLASS, mrb->class_class);
1030 if (m->tt == MRB_TT_ICLASS) {
1033 MRB_CLASS_ORIGIN(m);
1037 if (m->tt == MRB_TT_ICLASS) {
1047 include_module_at(mrb_state *mrb, struct RClass *c, struct RClass *ins_pos, struct RClass *m, int search_super)
1049 struct RClass *p, *ic;
1050 void *klass_mt = find_origin(c)->mt;
1053 int superclass_seen = 0;
1055 if (m->flags & MRB_FL_CLASS_IS_PREPENDED)
1058 if (klass_mt && klass_mt == m->mt)
1063 if (p->tt == MRB_TT_ICLASS) {
1064 if (p->mt == m->mt) {
1065 if (!superclass_seen) {
1066 ins_pos = p; /* move insert point */
1070 } else if (p->tt == MRB_TT_CLASS) {
1071 if (!search_super) break;
1072 superclass_seen = 1;
1077 ic = include_class_new(mrb, m, ins_pos->super);
1078 m->flags |= MRB_FL_CLASS_IS_INHERITED;
1079 ins_pos->super = ic;
1080 mrb_field_write_barrier(mrb, (struct RBasic*)ins_pos, (struct RBasic*)ic);
1081 mc_clear_by_class(mrb, ins_pos);
1091 mrb_include_module(mrb_state *mrb, struct RClass *c, struct RClass *m)
1093 int changed = include_module_at(mrb, c, find_origin(c), m, 1);
1095 mrb_raise(mrb, E_ARGUMENT_ERROR, "cyclic include detected");
1100 mrb_prepend_module(mrb_state *mrb, struct RClass *c, struct RClass *m)
1102 struct RClass *origin;
1105 if (!(c->flags & MRB_FL_CLASS_IS_PREPENDED)) {
1106 origin = (struct RClass*)mrb_obj_alloc(mrb, MRB_TT_ICLASS, c);
1107 origin->flags |= MRB_FL_CLASS_IS_ORIGIN | MRB_FL_CLASS_IS_INHERITED;
1108 origin->super = c->super;
1111 c->mt = kh_init(mt, mrb);
1112 mrb_field_write_barrier(mrb, (struct RBasic*)c, (struct RBasic*)origin);
1113 c->flags |= MRB_FL_CLASS_IS_PREPENDED;
1115 changed = include_module_at(mrb, c, c, m, 0);
1117 mrb_raise(mrb, E_ARGUMENT_ERROR, "cyclic prepend detected");
1122 mrb_mod_prepend_features(mrb_state *mrb, mrb_value mod)
1126 mrb_check_type(mrb, mod, MRB_TT_MODULE);
1127 mrb_get_args(mrb, "C", &klass);
1128 mrb_prepend_module(mrb, mrb_class_ptr(klass), mrb_class_ptr(mod));
1133 mrb_mod_append_features(mrb_state *mrb, mrb_value mod)
1137 mrb_check_type(mrb, mod, MRB_TT_MODULE);
1138 mrb_get_args(mrb, "C", &klass);
1139 mrb_include_module(mrb, mrb_class_ptr(klass), mrb_class_ptr(mod));
1146 * mod.include?(module) -> true or false
1148 * Returns <code>true</code> if <i>module</i> is included in
1149 * <i>mod</i> or one of <i>mod</i>'s ancestors.
1158 * B.include?(A) #=> true
1159 * C.include?(A) #=> true
1160 * A.include?(A) #=> false
1163 mrb_mod_include_p(mrb_state *mrb, mrb_value mod)
1166 struct RClass *c = mrb_class_ptr(mod);
1168 mrb_get_args(mrb, "C", &mod2);
1169 mrb_check_type(mrb, mod2, MRB_TT_MODULE);
1172 if (c->tt == MRB_TT_ICLASS) {
1173 if (c->c == mrb_class_ptr(mod2)) return mrb_true_value();
1177 return mrb_false_value();
1181 mrb_mod_ancestors(mrb_state *mrb, mrb_value self)
1184 struct RClass *c = mrb_class_ptr(self);
1185 result = mrb_ary_new(mrb);
1187 if (c->tt == MRB_TT_ICLASS) {
1188 mrb_ary_push(mrb, result, mrb_obj_value(c->c));
1190 else if (!(c->flags & MRB_FL_CLASS_IS_PREPENDED)) {
1191 mrb_ary_push(mrb, result, mrb_obj_value(c));
1200 mrb_mod_extend_object(mrb_state *mrb, mrb_value mod)
1204 mrb_check_type(mrb, mod, MRB_TT_MODULE);
1205 mrb_get_args(mrb, "o", &obj);
1206 mrb_include_module(mrb, mrb_class_ptr(mrb_singleton_class(mrb, obj)), mrb_class_ptr(mod));
1211 mrb_mod_initialize(mrb_state *mrb, mrb_value mod)
1214 struct RClass *m = mrb_class_ptr(mod);
1215 boot_initmod(mrb, m); /* bootstrap a newly initialized module */
1216 mrb_get_args(mrb, "|&", &b);
1217 if (!mrb_nil_p(b)) {
1218 mrb_yield_with_class(mrb, b, 1, &mod, mod, m);
1223 /* implementation of module_eval/class_eval */
1224 mrb_value mrb_mod_module_eval(mrb_state*, mrb_value);
1227 mrb_mod_dummy_visibility(mrb_state *mrb, mrb_value mod)
1233 mrb_singleton_class(mrb_state *mrb, mrb_value v)
1237 switch (mrb_type(v)) {
1240 return mrb_obj_value(mrb->nil_class);
1241 return mrb_obj_value(mrb->false_class);
1243 return mrb_obj_value(mrb->true_class);
1245 return mrb_obj_value(mrb->object_class);
1248 #ifndef MRB_WITHOUT_FLOAT
1251 mrb_raise(mrb, E_TYPE_ERROR, "can't define singleton");
1252 return mrb_nil_value(); /* not reached */
1256 obj = mrb_basic_ptr(v);
1257 prepare_singleton_class(mrb, obj);
1258 return mrb_obj_value(obj->c);
1262 mrb_define_singleton_method(mrb_state *mrb, struct RObject *o, const char *name, mrb_func_t func, mrb_aspec aspec)
1264 prepare_singleton_class(mrb, (struct RBasic*)o);
1265 mrb_define_method_id(mrb, o->c, mrb_intern_cstr(mrb, name), func, aspec);
1269 mrb_define_class_method(mrb_state *mrb, struct RClass *c, const char *name, mrb_func_t func, mrb_aspec aspec)
1271 mrb_define_singleton_method(mrb, (struct RObject*)c, name, func, aspec);
1275 mrb_define_module_function(mrb_state *mrb, struct RClass *c, const char *name, mrb_func_t func, mrb_aspec aspec)
1277 mrb_define_class_method(mrb, c, name, func, aspec);
1278 mrb_define_method(mrb, c, name, func, aspec);
1281 #ifdef MRB_METHOD_CACHE
1283 mc_clear_all(mrb_state *mrb)
1285 struct mrb_cache_entry *mc = mrb->cache;
1288 for (i=0; i<MRB_METHOD_CACHE_SIZE; i++) {
1294 mc_clear_by_class(mrb_state *mrb, struct RClass *c)
1296 struct mrb_cache_entry *mc = mrb->cache;
1299 if (c->flags & MRB_FL_CLASS_IS_INHERITED) {
1301 c->flags &= ~MRB_FL_CLASS_IS_INHERITED;
1304 for (i=0; i<MRB_METHOD_CACHE_SIZE; i++) {
1305 if (mc[i].c == c) mc[i].c = 0;
1310 mc_clear_by_id(mrb_state *mrb, struct RClass *c, mrb_sym mid)
1312 struct mrb_cache_entry *mc = mrb->cache;
1315 if (c->flags & MRB_FL_CLASS_IS_INHERITED) {
1317 c->flags &= ~MRB_FL_CLASS_IS_INHERITED;
1320 for (i=0; i<MRB_METHOD_CACHE_SIZE; i++) {
1321 if (mc[i].c == c || mc[i].mid == mid)
1327 MRB_API mrb_method_t
1328 mrb_method_search_vm(mrb_state *mrb, struct RClass **cp, mrb_sym mid)
1332 struct RClass *c = *cp;
1333 #ifdef MRB_METHOD_CACHE
1334 struct RClass *oc = c;
1335 int h = kh_int_hash_func(mrb, ((intptr_t)oc) ^ mid) & (MRB_METHOD_CACHE_SIZE-1);
1336 struct mrb_cache_entry *mc = &mrb->cache[h];
1338 if (mc->c == c && mc->mid == mid) {
1345 khash_t(mt) *h = c->mt;
1348 k = kh_get(mt, mrb, h, mid);
1349 if (k != kh_end(h)) {
1351 if (MRB_METHOD_UNDEF_P(m)) break;
1353 #ifdef MRB_METHOD_CACHE
1364 MRB_METHOD_FROM_PROC(m, NULL);
1365 return m; /* no method */
1368 MRB_API mrb_method_t
1369 mrb_method_search(mrb_state *mrb, struct RClass* c, mrb_sym mid)
1373 m = mrb_method_search_vm(mrb, &c, mid);
1374 if (MRB_METHOD_UNDEF_P(m)) {
1375 mrb_value inspect = mrb_funcall(mrb, mrb_obj_value(c), "inspect", 0);
1376 if (mrb_string_p(inspect) && RSTRING_LEN(inspect) > 64) {
1377 inspect = mrb_any_to_s(mrb, mrb_obj_value(c));
1379 mrb_name_error(mrb, mid, "undefined method '%S' for class %S",
1380 mrb_sym2str(mrb, mid), inspect);
1386 attr_reader(mrb_state *mrb, mrb_value obj)
1388 mrb_value name = mrb_proc_cfunc_env_get(mrb, 0);
1389 return mrb_iv_get(mrb, obj, to_sym(mrb, name));
1393 mrb_mod_attr_reader(mrb_state *mrb, mrb_value mod)
1395 struct RClass *c = mrb_class_ptr(mod);
1400 mrb_get_args(mrb, "*", &argv, &argc);
1401 ai = mrb_gc_arena_save(mrb);
1402 for (i=0; i<argc; i++) {
1403 mrb_value name, str;
1404 mrb_sym method, sym;
1408 method = to_sym(mrb, argv[i]);
1409 name = mrb_sym2str(mrb, method);
1410 str = mrb_str_new_capa(mrb, RSTRING_LEN(name)+1);
1411 mrb_str_cat_lit(mrb, str, "@");
1412 mrb_str_cat_str(mrb, str, name);
1413 sym = mrb_intern_str(mrb, str);
1414 mrb_iv_name_sym_check(mrb, sym);
1415 name = mrb_symbol_value(sym);
1416 p = mrb_proc_new_cfunc_with_env(mrb, attr_reader, 1, &name);
1417 MRB_METHOD_FROM_PROC(m, p);
1418 mrb_define_method_raw(mrb, c, method, m);
1419 mrb_gc_arena_restore(mrb, ai);
1421 return mrb_nil_value();
1425 attr_writer(mrb_state *mrb, mrb_value obj)
1427 mrb_value name = mrb_proc_cfunc_env_get(mrb, 0);
1430 mrb_get_args(mrb, "o", &val);
1431 mrb_iv_set(mrb, obj, to_sym(mrb, name), val);
1436 mrb_mod_attr_writer(mrb_state *mrb, mrb_value mod)
1438 struct RClass *c = mrb_class_ptr(mod);
1443 mrb_get_args(mrb, "*", &argv, &argc);
1444 ai = mrb_gc_arena_save(mrb);
1445 for (i=0; i<argc; i++) {
1446 mrb_value name, str, attr;
1447 mrb_sym method, sym;
1451 method = to_sym(mrb, argv[i]);
1453 /* prepare iv name (@name) */
1454 name = mrb_sym2str(mrb, method);
1455 str = mrb_str_new_capa(mrb, RSTRING_LEN(name)+1);
1456 mrb_str_cat_lit(mrb, str, "@");
1457 mrb_str_cat_str(mrb, str, name);
1458 sym = mrb_intern_str(mrb, str);
1459 mrb_iv_name_sym_check(mrb, sym);
1460 attr = mrb_symbol_value(sym);
1462 /* prepare method name (name=) */
1463 str = mrb_str_new_capa(mrb, RSTRING_LEN(str));
1464 mrb_str_cat_str(mrb, str, name);
1465 mrb_str_cat_lit(mrb, str, "=");
1466 method = mrb_intern_str(mrb, str);
1468 p = mrb_proc_new_cfunc_with_env(mrb, attr_writer, 1, &attr);
1469 MRB_METHOD_FROM_PROC(m, p);
1470 mrb_define_method_raw(mrb, c, method, m);
1471 mrb_gc_arena_restore(mrb, ai);
1473 return mrb_nil_value();
1477 mrb_instance_alloc(mrb_state *mrb, mrb_value cv)
1479 struct RClass *c = mrb_class_ptr(cv);
1481 enum mrb_vtype ttype = MRB_INSTANCE_TT(c);
1483 if (c->tt == MRB_TT_SCLASS)
1484 mrb_raise(mrb, E_TYPE_ERROR, "can't create instance of singleton class");
1486 if (ttype == 0) ttype = MRB_TT_OBJECT;
1487 if (ttype <= MRB_TT_CPTR) {
1488 mrb_raisef(mrb, E_TYPE_ERROR, "can't create instance of %S", cv);
1490 o = (struct RObject*)mrb_obj_alloc(mrb, ttype, c);
1491 return mrb_obj_value(o);
1496 * class.new(args, ...) -> obj
1498 * Creates a new object of <i>class</i>'s class, then
1499 * invokes that object's <code>initialize</code> method,
1500 * passing it <i>args</i>. This is the method that ends
1501 * up getting called whenever an object is constructed using
1507 mrb_instance_new(mrb_state *mrb, mrb_value cv)
1515 mrb_get_args(mrb, "*&", &argv, &argc, &blk);
1516 obj = mrb_instance_alloc(mrb, cv);
1517 init = mrb_intern_lit(mrb, "initialize");
1518 m = mrb_method_search(mrb, mrb_class(mrb, obj), init);
1519 if (MRB_METHOD_CFUNC_P(m)) {
1520 mrb_func_t f = MRB_METHOD_CFUNC(m);
1521 if (f != mrb_bob_init) {
1526 mrb_funcall_with_block(mrb, obj, init, argc, argv, blk);
1533 mrb_obj_new(mrb_state *mrb, struct RClass *c, mrb_int argc, const mrb_value *argv)
1538 obj = mrb_instance_alloc(mrb, mrb_obj_value(c));
1539 mid = mrb_intern_lit(mrb, "initialize");
1540 if (!mrb_func_basic_p(mrb, obj, mid, mrb_bob_init)) {
1541 mrb_funcall_argv(mrb, obj, mid, argc, argv);
1547 mrb_class_initialize(mrb_state *mrb, mrb_value c)
1551 mrb_get_args(mrb, "|C&", &a, &b);
1552 if (!mrb_nil_p(b)) {
1553 mrb_yield_with_class(mrb, b, 1, &c, c, mrb_class_ptr(c));
1559 mrb_class_new_class(mrb_state *mrb, mrb_value cv)
1562 mrb_value super, blk;
1563 mrb_value new_class;
1566 n = mrb_get_args(mrb, "|C&", &super, &blk);
1568 super = mrb_obj_value(mrb->object_class);
1570 new_class = mrb_obj_value(mrb_class_new(mrb, mrb_class_ptr(super)));
1571 mid = mrb_intern_lit(mrb, "initialize");
1572 if (!mrb_func_basic_p(mrb, new_class, mid, mrb_bob_init)) {
1573 mrb_funcall_with_block(mrb, new_class, mid, n, &super, blk);
1575 mrb_class_inherited(mrb, mrb_class_ptr(super), mrb_class_ptr(new_class));
1580 mrb_class_superclass(mrb_state *mrb, mrb_value klass)
1584 c = mrb_class_ptr(klass);
1585 c = find_origin(c)->super;
1586 while (c && c->tt == MRB_TT_ICLASS) {
1587 c = find_origin(c)->super;
1589 if (!c) return mrb_nil_value();
1590 return mrb_obj_value(c);
1594 mrb_bob_init(mrb_state *mrb, mrb_value cv)
1596 return mrb_nil_value();
1600 mrb_bob_not(mrb_state *mrb, mrb_value cv)
1602 return mrb_bool_value(!mrb_test(cv));
1610 * obj == other -> true or false
1611 * obj.equal?(other) -> true or false
1612 * obj.eql?(other) -> true or false
1614 * Equality---At the <code>Object</code> level, <code>==</code> returns
1615 * <code>true</code> only if <i>obj</i> and <i>other</i> are the
1616 * same object. Typically, this method is overridden in descendant
1617 * classes to provide class-specific meaning.
1619 * Unlike <code>==</code>, the <code>equal?</code> method should never be
1620 * overridden by subclasses: it is used to determine object identity
1621 * (that is, <code>a.equal?(b)</code> iff <code>a</code> is the same
1622 * object as <code>b</code>).
1624 * The <code>eql?</code> method returns <code>true</code> if
1625 * <i>obj</i> and <i>anObject</i> have the same value. Used by
1626 * <code>Hash</code> to test members for equality. For objects of
1627 * class <code>Object</code>, <code>eql?</code> is synonymous with
1628 * <code>==</code>. Subclasses normally continue this tradition, but
1629 * there are exceptions. <code>Numeric</code> types, for example,
1630 * perform type conversion across <code>==</code>, but not across
1631 * <code>eql?</code>, so:
1634 * 1.eql? 1.0 #=> false
1637 mrb_obj_equal_m(mrb_state *mrb, mrb_value self)
1641 mrb_get_args(mrb, "o", &arg);
1642 return mrb_bool_value(mrb_obj_equal(mrb, self, arg));
1646 mrb_obj_not_equal_m(mrb_state *mrb, mrb_value self)
1650 mrb_get_args(mrb, "o", &arg);
1651 return mrb_bool_value(!mrb_equal(mrb, self, arg));
1655 mrb_obj_respond_to(mrb_state *mrb, struct RClass* c, mrb_sym mid)
1659 m = mrb_method_search_vm(mrb, &c, mid);
1660 if (MRB_METHOD_UNDEF_P(m)) {
1667 mrb_respond_to(mrb_state *mrb, mrb_value obj, mrb_sym mid)
1669 return mrb_obj_respond_to(mrb, mrb_class(mrb, obj), mid);
1673 mrb_class_path(mrb_state *mrb, struct RClass *c)
1676 mrb_sym nsym = mrb_intern_lit(mrb, "__classname__");
1678 path = mrb_obj_iv_get(mrb, (struct RObject*)c, nsym);
1679 if (mrb_nil_p(path)) {
1681 return mrb_class_find_path(mrb, c);
1683 else if (mrb_symbol_p(path)) {
1684 /* toplevel class/module */
1685 return mrb_sym2str(mrb, mrb_symbol(path));
1687 return mrb_str_dup(mrb, path);
1690 MRB_API struct RClass*
1691 mrb_class_real(struct RClass* cl)
1693 if (cl == 0) return NULL;
1694 while ((cl->tt == MRB_TT_SCLASS) || (cl->tt == MRB_TT_ICLASS)) {
1696 if (cl == 0) return NULL;
1702 mrb_class_name(mrb_state *mrb, struct RClass* c)
1704 mrb_value name = class_name_str(mrb, c);
1705 return RSTRING_PTR(name);
1709 mrb_obj_classname(mrb_state *mrb, mrb_value obj)
1711 return mrb_class_name(mrb, mrb_obj_class(mrb, obj));
1715 * Ensures a class can be derived from super.
1717 * \param super a reference to an object.
1718 * \exception TypeError if \a super is not a Class or \a super is a singleton class.
1721 mrb_check_inheritable(mrb_state *mrb, struct RClass *super)
1723 if (super->tt != MRB_TT_CLASS) {
1724 mrb_raisef(mrb, E_TYPE_ERROR, "superclass must be a Class (%S given)", mrb_obj_value(super));
1726 if (super->tt == MRB_TT_SCLASS) {
1727 mrb_raise(mrb, E_TYPE_ERROR, "can't make subclass of singleton class");
1729 if (super == mrb->class_class) {
1730 mrb_raise(mrb, E_TYPE_ERROR, "can't make subclass of Class");
1735 * Creates a new class.
1736 * \param super a class from which the new class derives.
1737 * \exception TypeError \a super is not inheritable.
1738 * \exception TypeError \a super is the Class class.
1740 MRB_API struct RClass*
1741 mrb_class_new(mrb_state *mrb, struct RClass *super)
1746 mrb_check_inheritable(mrb, super);
1748 c = boot_defclass(mrb, super);
1750 MRB_SET_INSTANCE_TT(c, MRB_INSTANCE_TT(super));
1752 make_metaclass(mrb, c);
1758 * Creates a new module.
1760 MRB_API struct RClass*
1761 mrb_module_new(mrb_state *mrb)
1763 struct RClass *m = (struct RClass*)mrb_obj_alloc(mrb, MRB_TT_MODULE, mrb->module_class);
1764 boot_initmod(mrb, m);
1770 * obj.class => class
1772 * Returns the class of <i>obj</i>, now preferred over
1773 * <code>Object#type</code>, as an object's type in Ruby is only
1774 * loosely tied to that object's class. This method must always be
1775 * called with an explicit receiver, as <code>class</code> is also a
1776 * reserved word in Ruby.
1778 * 1.class #=> Fixnum
1779 * self.class #=> Object
1782 MRB_API struct RClass*
1783 mrb_obj_class(mrb_state *mrb, mrb_value obj)
1785 return mrb_class_real(mrb_class(mrb, obj));
1789 mrb_alias_method(mrb_state *mrb, struct RClass *c, mrb_sym a, mrb_sym b)
1791 mrb_method_t m = mrb_method_search(mrb, c, b);
1793 mrb_define_method_raw(mrb, c, a, m);
1797 * Defines an alias of a method.
1798 * \param klass the class which the original method belongs to
1799 * \param name1 a new name for the method
1800 * \param name2 the original name of the method
1803 mrb_define_alias(mrb_state *mrb, struct RClass *klass, const char *name1, const char *name2)
1805 mrb_alias_method(mrb, klass, mrb_intern_cstr(mrb, name1), mrb_intern_cstr(mrb, name2));
1810 * mod.to_s -> string
1812 * Return a string representing this module or class. For basic
1813 * classes and modules, this is the name. For singletons, we
1814 * show information on the thing we're attached to as well.
1818 mrb_mod_to_s(mrb_state *mrb, mrb_value klass)
1821 if (mrb_type(klass) == MRB_TT_SCLASS) {
1822 mrb_value v = mrb_iv_get(mrb, klass, mrb_intern_lit(mrb, "__attached__"));
1823 mrb_value str = mrb_str_new_lit(mrb, "#<Class:");
1825 if (class_ptr_p(v)) {
1826 mrb_str_cat_str(mrb, str, mrb_inspect(mrb, v));
1829 mrb_str_cat_str(mrb, str, mrb_any_to_s(mrb, v));
1831 return mrb_str_cat_lit(mrb, str, ">");
1834 return class_name_str(mrb, mrb_class_ptr(klass));
1839 mrb_mod_alias(mrb_state *mrb, mrb_value mod)
1841 struct RClass *c = mrb_class_ptr(mod);
1842 mrb_sym new_name, old_name;
1844 mrb_get_args(mrb, "nn", &new_name, &old_name);
1845 mrb_alias_method(mrb, c, new_name, old_name);
1846 return mrb_nil_value();
1850 mrb_undef_method_id(mrb_state *mrb, struct RClass *c, mrb_sym a)
1852 if (!mrb_obj_respond_to(mrb, c, a)) {
1853 mrb_name_error(mrb, a, "undefined method '%S' for class '%S'", mrb_sym2str(mrb, a), mrb_obj_value(c));
1858 MRB_METHOD_FROM_PROC(m, NULL);
1859 mrb_define_method_raw(mrb, c, a, m);
1864 mrb_undef_method(mrb_state *mrb, struct RClass *c, const char *name)
1866 mrb_undef_method_id(mrb, c, mrb_intern_cstr(mrb, name));
1870 mrb_undef_class_method(mrb_state *mrb, struct RClass *c, const char *name)
1872 mrb_undef_method(mrb, mrb_class_ptr(mrb_singleton_class(mrb, mrb_obj_value(c))), name);
1876 mrb_mod_undef(mrb_state *mrb, mrb_value mod)
1878 struct RClass *c = mrb_class_ptr(mod);
1882 mrb_get_args(mrb, "*", &argv, &argc);
1884 mrb_undef_method_id(mrb, c, to_sym(mrb, *argv));
1887 return mrb_nil_value();
1891 const_name_p(mrb_state *mrb, const char *name, mrb_int len)
1893 return len > 0 && ISUPPER(name[0]) && mrb_ident_p(name+1, len-1);
1897 check_const_name_sym(mrb_state *mrb, mrb_sym id)
1900 const char *name = mrb_sym2name_len(mrb, id, &len);
1901 if (!const_name_p(mrb, name, len)) {
1902 mrb_name_error(mrb, id, "wrong constant name %S", mrb_sym2str(mrb, id));
1907 mrb_mod_const_defined(mrb_state *mrb, mrb_value mod)
1910 mrb_bool inherit = TRUE;
1912 mrb_get_args(mrb, "n|b", &id, &inherit);
1913 check_const_name_sym(mrb, id);
1915 return mrb_bool_value(mrb_const_defined(mrb, mod, id));
1917 return mrb_bool_value(mrb_const_defined_at(mrb, mod, id));
1921 mrb_const_get_sym(mrb_state *mrb, mrb_value mod, mrb_sym id)
1923 check_const_name_sym(mrb, id);
1924 return mrb_const_get(mrb, mod, id);
1928 mrb_mod_const_get(mrb_state *mrb, mrb_value mod)
1933 mrb_int off, end, len;
1935 mrb_get_args(mrb, "o", &path);
1937 if (mrb_symbol_p(path)) {
1938 /* const get with symbol */
1939 id = mrb_symbol(path);
1940 return mrb_const_get_sym(mrb, mod, id);
1943 /* const get with class path string */
1944 path = mrb_ensure_string_type(mrb, path);
1945 ptr = RSTRING_PTR(path);
1946 len = RSTRING_LEN(path);
1950 end = mrb_str_index_lit(mrb, path, "::", off);
1951 end = (end == -1) ? len : end;
1952 id = mrb_intern(mrb, ptr+off, end-off);
1953 mod = mrb_const_get_sym(mrb, mod, id);
1958 if (off == len) { /* trailing "::" */
1959 mrb_name_error(mrb, id, "wrong constant name '%S'", path);
1968 mrb_mod_const_set(mrb_state *mrb, mrb_value mod)
1973 mrb_get_args(mrb, "no", &id, &value);
1974 check_const_name_sym(mrb, id);
1975 mrb_const_set(mrb, mod, id, value);
1980 mrb_mod_remove_const(mrb_state *mrb, mrb_value mod)
1985 mrb_get_args(mrb, "n", &id);
1986 check_const_name_sym(mrb, id);
1987 val = mrb_iv_remove(mrb, mod, id);
1988 if (mrb_undef_p(val)) {
1989 mrb_name_error(mrb, id, "constant %S not defined", mrb_sym2str(mrb, id));
1995 mrb_mod_const_missing(mrb_state *mrb, mrb_value mod)
1999 mrb_get_args(mrb, "n", &sym);
2001 if (mrb_class_real(mrb_class_ptr(mod)) != mrb->object_class) {
2002 mrb_name_error(mrb, sym, "uninitialized constant %S::%S",
2004 mrb_sym2str(mrb, sym));
2007 mrb_name_error(mrb, sym, "uninitialized constant %S",
2008 mrb_sym2str(mrb, sym));
2011 return mrb_nil_value();
2017 * mod.method_defined?(symbol) -> true or false
2019 * Returns +true+ if the named method is defined by
2020 * _mod_ (or its included modules and, if _mod_ is a class,
2021 * its ancestors). Public and protected methods are matched.
2034 * A.method_defined? :method1 #=> true
2035 * C.method_defined? "method1" #=> true
2036 * C.method_defined? "method2" #=> true
2037 * C.method_defined? "method3" #=> true
2038 * C.method_defined? "method4" #=> false
2042 mrb_mod_method_defined(mrb_state *mrb, mrb_value mod)
2046 mrb_get_args(mrb, "n", &id);
2047 return mrb_bool_value(mrb_obj_respond_to(mrb, mrb_class_ptr(mod), id));
2051 mod_define_method(mrb_state *mrb, mrb_value self)
2053 struct RClass *c = mrb_class_ptr(self);
2057 mrb_value proc = mrb_undef_value();
2060 mrb_get_args(mrb, "n|o&", &mid, &proc, &blk);
2061 switch (mrb_type(proc)) {
2069 mrb_raisef(mrb, E_TYPE_ERROR, "wrong argument type %S (expected Proc)", mrb_obj_value(mrb_obj_class(mrb, proc)));
2072 if (mrb_nil_p(blk)) {
2073 mrb_raise(mrb, E_ARGUMENT_ERROR, "no block given");
2075 p = (struct RProc*)mrb_obj_alloc(mrb, MRB_TT_PROC, mrb->proc_class);
2076 mrb_proc_copy(p, mrb_proc_ptr(blk));
2077 p->flags |= MRB_PROC_STRICT;
2078 MRB_METHOD_FROM_PROC(m, p);
2079 mrb_define_method_raw(mrb, c, mid, m);
2080 return mrb_symbol_value(mid);
2084 top_define_method(mrb_state *mrb, mrb_value self)
2086 return mod_define_method(mrb, mrb_obj_value(mrb->object_class));
2090 mrb_mod_eqq(mrb_state *mrb, mrb_value mod)
2095 mrb_get_args(mrb, "o", &obj);
2096 eqq = mrb_obj_is_kind_of(mrb, obj, mrb_class_ptr(mod));
2098 return mrb_bool_value(eqq);
2102 mrb_mod_module_function(mrb_state *mrb, mrb_value mod)
2108 struct RClass *rclass;
2111 mrb_check_type(mrb, mod, MRB_TT_MODULE);
2113 mrb_get_args(mrb, "*", &argv, &argc);
2115 /* set MODFUNC SCOPE if implemented */
2119 /* set PRIVATE method visibility if implemented */
2120 /* mrb_mod_dummy_visibility(mrb, mod); */
2122 for (i=0; i<argc; i++) {
2123 mrb_check_type(mrb, argv[i], MRB_TT_SYMBOL);
2125 mid = mrb_symbol(argv[i]);
2126 rclass = mrb_class_ptr(mod);
2127 m = mrb_method_search(mrb, rclass, mid);
2129 prepare_singleton_class(mrb, (struct RBasic*)rclass);
2130 ai = mrb_gc_arena_save(mrb);
2131 mrb_define_method_raw(mrb, rclass->c, mid, m);
2132 mrb_gc_arena_restore(mrb, ai);
2138 /* implementation of __id__ */
2139 mrb_value mrb_obj_id_m(mrb_state *mrb, mrb_value self);
2140 /* implementation of instance_eval */
2141 mrb_value mrb_obj_instance_eval(mrb_state*, mrb_value);
2144 inspect_main(mrb_state *mrb, mrb_value mod)
2146 return mrb_str_new_lit(mrb, "main");
2150 mrb_init_class(mrb_state *mrb)
2152 struct RClass *bob; /* BasicObject */
2153 struct RClass *obj; /* Object */
2154 struct RClass *mod; /* Module */
2155 struct RClass *cls; /* Class */
2157 /* boot class hierarchy */
2158 bob = boot_defclass(mrb, 0);
2159 obj = boot_defclass(mrb, bob); mrb->object_class = obj;
2160 mod = boot_defclass(mrb, obj); mrb->module_class = mod;/* obj -> mod */
2161 cls = boot_defclass(mrb, mod); mrb->class_class = cls; /* obj -> cls */
2162 /* fix-up loose ends */
2163 bob->c = obj->c = mod->c = cls->c = cls;
2164 make_metaclass(mrb, bob);
2165 make_metaclass(mrb, obj);
2166 make_metaclass(mrb, mod);
2167 make_metaclass(mrb, cls);
2169 /* name basic classes */
2170 mrb_define_const(mrb, bob, "BasicObject", mrb_obj_value(bob));
2171 mrb_define_const(mrb, obj, "BasicObject", mrb_obj_value(bob));
2172 mrb_define_const(mrb, obj, "Object", mrb_obj_value(obj));
2173 mrb_define_const(mrb, obj, "Module", mrb_obj_value(mod));
2174 mrb_define_const(mrb, obj, "Class", mrb_obj_value(cls));
2176 /* name each classes */
2177 mrb_class_name_class(mrb, NULL, bob, mrb_intern_lit(mrb, "BasicObject"));
2178 mrb_class_name_class(mrb, NULL, obj, mrb_intern_lit(mrb, "Object")); /* 15.2.1 */
2179 mrb_class_name_class(mrb, NULL, mod, mrb_intern_lit(mrb, "Module")); /* 15.2.2 */
2180 mrb_class_name_class(mrb, NULL, cls, mrb_intern_lit(mrb, "Class")); /* 15.2.3 */
2182 mrb->proc_class = mrb_define_class(mrb, "Proc", mrb->object_class); /* 15.2.17 */
2183 MRB_SET_INSTANCE_TT(mrb->proc_class, MRB_TT_PROC);
2185 MRB_SET_INSTANCE_TT(cls, MRB_TT_CLASS);
2186 mrb_define_method(mrb, bob, "initialize", mrb_bob_init, MRB_ARGS_NONE());
2187 mrb_define_method(mrb, bob, "!", mrb_bob_not, MRB_ARGS_NONE());
2188 mrb_define_method(mrb, bob, "==", mrb_obj_equal_m, MRB_ARGS_REQ(1)); /* 15.3.1.3.1 */
2189 mrb_define_method(mrb, bob, "!=", mrb_obj_not_equal_m, MRB_ARGS_REQ(1));
2190 mrb_define_method(mrb, bob, "__id__", mrb_obj_id_m, MRB_ARGS_NONE()); /* 15.3.1.3.4 */
2191 mrb_define_method(mrb, bob, "__send__", mrb_f_send, MRB_ARGS_ANY()); /* 15.3.1.3.5 */
2192 mrb_define_method(mrb, bob, "instance_eval", mrb_obj_instance_eval, MRB_ARGS_ANY()); /* 15.3.1.3.18 */
2194 mrb_define_class_method(mrb, cls, "new", mrb_class_new_class, MRB_ARGS_OPT(1));
2195 mrb_define_method(mrb, cls, "superclass", mrb_class_superclass, MRB_ARGS_NONE()); /* 15.2.3.3.4 */
2196 mrb_define_method(mrb, cls, "new", mrb_instance_new, MRB_ARGS_ANY()); /* 15.2.3.3.3 */
2197 mrb_define_method(mrb, cls, "initialize", mrb_class_initialize, MRB_ARGS_OPT(1)); /* 15.2.3.3.1 */
2198 mrb_define_method(mrb, cls, "inherited", mrb_bob_init, MRB_ARGS_REQ(1));
2200 MRB_SET_INSTANCE_TT(mod, MRB_TT_MODULE);
2201 mrb_define_method(mrb, mod, "extend_object", mrb_mod_extend_object, MRB_ARGS_REQ(1)); /* 15.2.2.4.25 */
2202 mrb_define_method(mrb, mod, "extended", mrb_bob_init, MRB_ARGS_REQ(1)); /* 15.2.2.4.26 */
2203 mrb_define_method(mrb, mod, "prepended", mrb_bob_init, MRB_ARGS_REQ(1));
2204 mrb_define_method(mrb, mod, "prepend_features", mrb_mod_prepend_features, MRB_ARGS_REQ(1));
2205 mrb_define_method(mrb, mod, "include?", mrb_mod_include_p, MRB_ARGS_REQ(1)); /* 15.2.2.4.28 */
2206 mrb_define_method(mrb, mod, "append_features", mrb_mod_append_features, MRB_ARGS_REQ(1)); /* 15.2.2.4.10 */
2207 mrb_define_method(mrb, mod, "class_eval", mrb_mod_module_eval, MRB_ARGS_ANY()); /* 15.2.2.4.15 */
2208 mrb_define_method(mrb, mod, "included", mrb_bob_init, MRB_ARGS_REQ(1)); /* 15.2.2.4.29 */
2209 mrb_define_method(mrb, mod, "initialize", mrb_mod_initialize, MRB_ARGS_NONE()); /* 15.2.2.4.31 */
2210 mrb_define_method(mrb, mod, "module_eval", mrb_mod_module_eval, MRB_ARGS_ANY()); /* 15.2.2.4.35 */
2211 mrb_define_method(mrb, mod, "module_function", mrb_mod_module_function, MRB_ARGS_ANY());
2212 mrb_define_method(mrb, mod, "private", mrb_mod_dummy_visibility, MRB_ARGS_ANY()); /* 15.2.2.4.36 */
2213 mrb_define_method(mrb, mod, "protected", mrb_mod_dummy_visibility, MRB_ARGS_ANY()); /* 15.2.2.4.37 */
2214 mrb_define_method(mrb, mod, "public", mrb_mod_dummy_visibility, MRB_ARGS_ANY()); /* 15.2.2.4.38 */
2215 mrb_define_method(mrb, mod, "attr_reader", mrb_mod_attr_reader, MRB_ARGS_ANY()); /* 15.2.2.4.13 */
2216 mrb_define_method(mrb, mod, "attr_writer", mrb_mod_attr_writer, MRB_ARGS_ANY()); /* 15.2.2.4.14 */
2217 mrb_define_method(mrb, mod, "to_s", mrb_mod_to_s, MRB_ARGS_NONE());
2218 mrb_define_method(mrb, mod, "inspect", mrb_mod_to_s, MRB_ARGS_NONE());
2219 mrb_define_method(mrb, mod, "alias_method", mrb_mod_alias, MRB_ARGS_ANY()); /* 15.2.2.4.8 */
2220 mrb_define_method(mrb, mod, "ancestors", mrb_mod_ancestors, MRB_ARGS_NONE()); /* 15.2.2.4.9 */
2221 mrb_define_method(mrb, mod, "undef_method", mrb_mod_undef, MRB_ARGS_ANY()); /* 15.2.2.4.41 */
2222 mrb_define_method(mrb, mod, "const_defined?", mrb_mod_const_defined, MRB_ARGS_ARG(1,1)); /* 15.2.2.4.20 */
2223 mrb_define_method(mrb, mod, "const_get", mrb_mod_const_get, MRB_ARGS_REQ(1)); /* 15.2.2.4.21 */
2224 mrb_define_method(mrb, mod, "const_set", mrb_mod_const_set, MRB_ARGS_REQ(2)); /* 15.2.2.4.23 */
2225 mrb_define_method(mrb, mod, "remove_const", mrb_mod_remove_const, MRB_ARGS_REQ(1)); /* 15.2.2.4.40 */
2226 mrb_define_method(mrb, mod, "const_missing", mrb_mod_const_missing, MRB_ARGS_REQ(1));
2227 mrb_define_method(mrb, mod, "method_defined?", mrb_mod_method_defined, MRB_ARGS_REQ(1)); /* 15.2.2.4.34 */
2228 mrb_define_method(mrb, mod, "define_method", mod_define_method, MRB_ARGS_ARG(1,1));
2229 mrb_define_method(mrb, mod, "===", mrb_mod_eqq, MRB_ARGS_REQ(1));
2231 mrb_undef_method(mrb, cls, "append_features");
2232 mrb_undef_method(mrb, cls, "extend_object");
2234 mrb->top_self = (struct RObject*)mrb_obj_alloc(mrb, MRB_TT_OBJECT, mrb->object_class);
2235 mrb_define_singleton_method(mrb, mrb->top_self, "inspect", inspect_main, MRB_ARGS_NONE());
2236 mrb_define_singleton_method(mrb, mrb->top_self, "to_s", inspect_main, MRB_ARGS_NONE());
2237 mrb_define_singleton_method(mrb, mrb->top_self, "define_method", top_define_method, MRB_ARGS_ARG(1,1));