[270] | 1 | /*
|
---|
| 2 | ** object.c - Object, NilClass, TrueClass, FalseClass class
|
---|
| 3 | **
|
---|
| 4 | ** See Copyright Notice in mruby.h
|
---|
| 5 | */
|
---|
| 6 |
|
---|
[331] | 7 | #include <mruby.h>
|
---|
| 8 | #include <mruby/class.h>
|
---|
| 9 | #include <mruby/numeric.h>
|
---|
| 10 | #include <mruby/string.h>
|
---|
| 11 | #include <mruby/class.h>
|
---|
[270] | 12 |
|
---|
| 13 | MRB_API mrb_bool
|
---|
| 14 | mrb_obj_eq(mrb_state *mrb, mrb_value v1, mrb_value v2)
|
---|
| 15 | {
|
---|
| 16 | if (mrb_type(v1) != mrb_type(v2)) return FALSE;
|
---|
| 17 | switch (mrb_type(v1)) {
|
---|
| 18 | case MRB_TT_TRUE:
|
---|
| 19 | return TRUE;
|
---|
| 20 |
|
---|
| 21 | case MRB_TT_FALSE:
|
---|
| 22 | case MRB_TT_FIXNUM:
|
---|
| 23 | return (mrb_fixnum(v1) == mrb_fixnum(v2));
|
---|
| 24 | case MRB_TT_SYMBOL:
|
---|
| 25 | return (mrb_symbol(v1) == mrb_symbol(v2));
|
---|
| 26 |
|
---|
[439] | 27 | #ifndef MRB_WITHOUT_FLOAT
|
---|
[270] | 28 | case MRB_TT_FLOAT:
|
---|
| 29 | return (mrb_float(v1) == mrb_float(v2));
|
---|
[439] | 30 | #endif
|
---|
[270] | 31 |
|
---|
| 32 | default:
|
---|
| 33 | return (mrb_ptr(v1) == mrb_ptr(v2));
|
---|
| 34 | }
|
---|
| 35 | }
|
---|
| 36 |
|
---|
| 37 | MRB_API mrb_bool
|
---|
| 38 | mrb_obj_equal(mrb_state *mrb, mrb_value v1, mrb_value v2)
|
---|
| 39 | {
|
---|
| 40 | /* temporary definition */
|
---|
| 41 | return mrb_obj_eq(mrb, v1, v2);
|
---|
| 42 | }
|
---|
| 43 |
|
---|
| 44 | MRB_API mrb_bool
|
---|
| 45 | mrb_equal(mrb_state *mrb, mrb_value obj1, mrb_value obj2)
|
---|
| 46 | {
|
---|
| 47 | mrb_value result;
|
---|
| 48 |
|
---|
| 49 | if (mrb_obj_eq(mrb, obj1, obj2)) return TRUE;
|
---|
| 50 | result = mrb_funcall(mrb, obj1, "==", 1, obj2);
|
---|
| 51 | if (mrb_test(result)) return TRUE;
|
---|
| 52 | return FALSE;
|
---|
| 53 | }
|
---|
| 54 |
|
---|
| 55 | /*
|
---|
| 56 | * Document-class: NilClass
|
---|
| 57 | *
|
---|
| 58 | * The class of the singleton object <code>nil</code>.
|
---|
| 59 | */
|
---|
| 60 |
|
---|
| 61 | /* 15.2.4.3.4 */
|
---|
| 62 | /*
|
---|
| 63 | * call_seq:
|
---|
| 64 | * nil.nil? -> true
|
---|
| 65 | *
|
---|
| 66 | * Only the object <i>nil</i> responds <code>true</code> to <code>nil?</code>.
|
---|
| 67 | */
|
---|
| 68 |
|
---|
| 69 | static mrb_value
|
---|
| 70 | mrb_true(mrb_state *mrb, mrb_value obj)
|
---|
| 71 | {
|
---|
| 72 | return mrb_true_value();
|
---|
| 73 | }
|
---|
| 74 |
|
---|
| 75 | /* 15.2.4.3.5 */
|
---|
| 76 | /*
|
---|
| 77 | * call-seq:
|
---|
| 78 | * nil.to_s -> ""
|
---|
| 79 | *
|
---|
| 80 | * Always returns the empty string.
|
---|
| 81 | */
|
---|
| 82 |
|
---|
| 83 | static mrb_value
|
---|
| 84 | nil_to_s(mrb_state *mrb, mrb_value obj)
|
---|
| 85 | {
|
---|
[439] | 86 | return mrb_str_new_frozen(mrb, 0, 0);
|
---|
[270] | 87 | }
|
---|
| 88 |
|
---|
| 89 | static mrb_value
|
---|
| 90 | nil_inspect(mrb_state *mrb, mrb_value obj)
|
---|
| 91 | {
|
---|
[439] | 92 | return mrb_str_new_lit_frozen(mrb, "nil");
|
---|
[270] | 93 | }
|
---|
| 94 |
|
---|
| 95 | /***********************************************************************
|
---|
| 96 | * Document-class: TrueClass
|
---|
| 97 | *
|
---|
| 98 | * The global value <code>true</code> is the only instance of class
|
---|
| 99 | * <code>TrueClass</code> and represents a logically true value in
|
---|
| 100 | * boolean expressions. The class provides operators allowing
|
---|
| 101 | * <code>true</code> to be used in logical expressions.
|
---|
| 102 | */
|
---|
| 103 |
|
---|
| 104 | /* 15.2.5.3.1 */
|
---|
| 105 | /*
|
---|
| 106 | * call-seq:
|
---|
| 107 | * true & obj -> true or false
|
---|
| 108 | *
|
---|
| 109 | * And---Returns <code>false</code> if <i>obj</i> is
|
---|
| 110 | * <code>nil</code> or <code>false</code>, <code>true</code> otherwise.
|
---|
| 111 | */
|
---|
| 112 |
|
---|
| 113 | static mrb_value
|
---|
| 114 | true_and(mrb_state *mrb, mrb_value obj)
|
---|
| 115 | {
|
---|
| 116 | mrb_bool obj2;
|
---|
| 117 |
|
---|
| 118 | mrb_get_args(mrb, "b", &obj2);
|
---|
| 119 |
|
---|
| 120 | return mrb_bool_value(obj2);
|
---|
| 121 | }
|
---|
| 122 |
|
---|
| 123 | /* 15.2.5.3.2 */
|
---|
| 124 | /*
|
---|
| 125 | * call-seq:
|
---|
| 126 | * true ^ obj -> !obj
|
---|
| 127 | *
|
---|
| 128 | * Exclusive Or---Returns <code>true</code> if <i>obj</i> is
|
---|
| 129 | * <code>nil</code> or <code>false</code>, <code>false</code>
|
---|
| 130 | * otherwise.
|
---|
| 131 | */
|
---|
| 132 |
|
---|
| 133 | static mrb_value
|
---|
| 134 | true_xor(mrb_state *mrb, mrb_value obj)
|
---|
| 135 | {
|
---|
| 136 | mrb_bool obj2;
|
---|
| 137 |
|
---|
| 138 | mrb_get_args(mrb, "b", &obj2);
|
---|
| 139 | return mrb_bool_value(!obj2);
|
---|
| 140 | }
|
---|
| 141 |
|
---|
| 142 | /* 15.2.5.3.3 */
|
---|
| 143 | /*
|
---|
| 144 | * call-seq:
|
---|
| 145 | * true.to_s -> "true"
|
---|
| 146 | *
|
---|
| 147 | * The string representation of <code>true</code> is "true".
|
---|
| 148 | */
|
---|
| 149 |
|
---|
| 150 | static mrb_value
|
---|
| 151 | true_to_s(mrb_state *mrb, mrb_value obj)
|
---|
| 152 | {
|
---|
[439] | 153 | return mrb_str_new_lit_frozen(mrb, "true");
|
---|
[270] | 154 | }
|
---|
| 155 |
|
---|
| 156 | /* 15.2.5.3.4 */
|
---|
| 157 | /*
|
---|
| 158 | * call-seq:
|
---|
| 159 | * true | obj -> true
|
---|
| 160 | *
|
---|
| 161 | * Or---Returns <code>true</code>. As <i>anObject</i> is an argument to
|
---|
| 162 | * a method call, it is always evaluated; there is no short-circuit
|
---|
| 163 | * evaluation in this case.
|
---|
| 164 | *
|
---|
| 165 | * true | puts("or")
|
---|
| 166 | * true || puts("logical or")
|
---|
| 167 | *
|
---|
| 168 | * <em>produces:</em>
|
---|
| 169 | *
|
---|
| 170 | * or
|
---|
| 171 | */
|
---|
| 172 |
|
---|
| 173 | static mrb_value
|
---|
| 174 | true_or(mrb_state *mrb, mrb_value obj)
|
---|
| 175 | {
|
---|
| 176 | return mrb_true_value();
|
---|
| 177 | }
|
---|
| 178 |
|
---|
| 179 | /*
|
---|
| 180 | * Document-class: FalseClass
|
---|
| 181 | *
|
---|
| 182 | * The global value <code>false</code> is the only instance of class
|
---|
| 183 | * <code>FalseClass</code> and represents a logically false value in
|
---|
| 184 | * boolean expressions. The class provides operators allowing
|
---|
| 185 | * <code>false</code> to participate correctly in logical expressions.
|
---|
| 186 | *
|
---|
| 187 | */
|
---|
| 188 |
|
---|
| 189 | /* 15.2.4.3.1 */
|
---|
| 190 | /* 15.2.6.3.1 */
|
---|
| 191 | /*
|
---|
| 192 | * call-seq:
|
---|
| 193 | * false & obj -> false
|
---|
| 194 | * nil & obj -> false
|
---|
| 195 | *
|
---|
| 196 | * And---Returns <code>false</code>. <i>obj</i> is always
|
---|
| 197 | * evaluated as it is the argument to a method call---there is no
|
---|
| 198 | * short-circuit evaluation in this case.
|
---|
| 199 | */
|
---|
| 200 |
|
---|
| 201 | static mrb_value
|
---|
| 202 | false_and(mrb_state *mrb, mrb_value obj)
|
---|
| 203 | {
|
---|
| 204 | return mrb_false_value();
|
---|
| 205 | }
|
---|
| 206 |
|
---|
| 207 | /* 15.2.4.3.2 */
|
---|
| 208 | /* 15.2.6.3.2 */
|
---|
| 209 | /*
|
---|
| 210 | * call-seq:
|
---|
| 211 | * false ^ obj -> true or false
|
---|
| 212 | * nil ^ obj -> true or false
|
---|
| 213 | *
|
---|
| 214 | * Exclusive Or---If <i>obj</i> is <code>nil</code> or
|
---|
| 215 | * <code>false</code>, returns <code>false</code>; otherwise, returns
|
---|
| 216 | * <code>true</code>.
|
---|
| 217 | *
|
---|
| 218 | */
|
---|
| 219 |
|
---|
| 220 | static mrb_value
|
---|
| 221 | false_xor(mrb_state *mrb, mrb_value obj)
|
---|
| 222 | {
|
---|
| 223 | mrb_bool obj2;
|
---|
| 224 |
|
---|
| 225 | mrb_get_args(mrb, "b", &obj2);
|
---|
| 226 | return mrb_bool_value(obj2);
|
---|
| 227 | }
|
---|
| 228 |
|
---|
| 229 | /* 15.2.4.3.3 */
|
---|
| 230 | /* 15.2.6.3.4 */
|
---|
| 231 | /*
|
---|
| 232 | * call-seq:
|
---|
| 233 | * false | obj -> true or false
|
---|
| 234 | * nil | obj -> true or false
|
---|
| 235 | *
|
---|
| 236 | * Or---Returns <code>false</code> if <i>obj</i> is
|
---|
| 237 | * <code>nil</code> or <code>false</code>; <code>true</code> otherwise.
|
---|
| 238 | */
|
---|
| 239 |
|
---|
| 240 | static mrb_value
|
---|
| 241 | false_or(mrb_state *mrb, mrb_value obj)
|
---|
| 242 | {
|
---|
| 243 | mrb_bool obj2;
|
---|
| 244 |
|
---|
| 245 | mrb_get_args(mrb, "b", &obj2);
|
---|
| 246 | return mrb_bool_value(obj2);
|
---|
| 247 | }
|
---|
| 248 |
|
---|
| 249 | /* 15.2.6.3.3 */
|
---|
| 250 | /*
|
---|
| 251 | * call-seq:
|
---|
| 252 | * false.to_s -> "false"
|
---|
| 253 | *
|
---|
| 254 | * 'nuf said...
|
---|
| 255 | */
|
---|
| 256 |
|
---|
| 257 | static mrb_value
|
---|
| 258 | false_to_s(mrb_state *mrb, mrb_value obj)
|
---|
| 259 | {
|
---|
[439] | 260 | return mrb_str_new_lit_frozen(mrb, "false");
|
---|
[270] | 261 | }
|
---|
| 262 |
|
---|
| 263 | void
|
---|
| 264 | mrb_init_object(mrb_state *mrb)
|
---|
| 265 | {
|
---|
| 266 | struct RClass *n;
|
---|
| 267 | struct RClass *t;
|
---|
| 268 | struct RClass *f;
|
---|
| 269 |
|
---|
| 270 | mrb->nil_class = n = mrb_define_class(mrb, "NilClass", mrb->object_class);
|
---|
[331] | 271 | MRB_SET_INSTANCE_TT(n, MRB_TT_TRUE);
|
---|
[270] | 272 | mrb_undef_class_method(mrb, n, "new");
|
---|
| 273 | mrb_define_method(mrb, n, "&", false_and, MRB_ARGS_REQ(1)); /* 15.2.4.3.1 */
|
---|
| 274 | mrb_define_method(mrb, n, "^", false_xor, MRB_ARGS_REQ(1)); /* 15.2.4.3.2 */
|
---|
| 275 | mrb_define_method(mrb, n, "|", false_or, MRB_ARGS_REQ(1)); /* 15.2.4.3.3 */
|
---|
| 276 | mrb_define_method(mrb, n, "nil?", mrb_true, MRB_ARGS_NONE()); /* 15.2.4.3.4 */
|
---|
| 277 | mrb_define_method(mrb, n, "to_s", nil_to_s, MRB_ARGS_NONE()); /* 15.2.4.3.5 */
|
---|
| 278 | mrb_define_method(mrb, n, "inspect", nil_inspect, MRB_ARGS_NONE());
|
---|
| 279 |
|
---|
| 280 | mrb->true_class = t = mrb_define_class(mrb, "TrueClass", mrb->object_class);
|
---|
[331] | 281 | MRB_SET_INSTANCE_TT(t, MRB_TT_TRUE);
|
---|
[270] | 282 | mrb_undef_class_method(mrb, t, "new");
|
---|
| 283 | mrb_define_method(mrb, t, "&", true_and, MRB_ARGS_REQ(1)); /* 15.2.5.3.1 */
|
---|
| 284 | mrb_define_method(mrb, t, "^", true_xor, MRB_ARGS_REQ(1)); /* 15.2.5.3.2 */
|
---|
| 285 | mrb_define_method(mrb, t, "to_s", true_to_s, MRB_ARGS_NONE()); /* 15.2.5.3.3 */
|
---|
| 286 | mrb_define_method(mrb, t, "|", true_or, MRB_ARGS_REQ(1)); /* 15.2.5.3.4 */
|
---|
| 287 | mrb_define_method(mrb, t, "inspect", true_to_s, MRB_ARGS_NONE());
|
---|
| 288 |
|
---|
| 289 | mrb->false_class = f = mrb_define_class(mrb, "FalseClass", mrb->object_class);
|
---|
[331] | 290 | MRB_SET_INSTANCE_TT(f, MRB_TT_TRUE);
|
---|
[270] | 291 | mrb_undef_class_method(mrb, f, "new");
|
---|
| 292 | mrb_define_method(mrb, f, "&", false_and, MRB_ARGS_REQ(1)); /* 15.2.6.3.1 */
|
---|
| 293 | mrb_define_method(mrb, f, "^", false_xor, MRB_ARGS_REQ(1)); /* 15.2.6.3.2 */
|
---|
| 294 | mrb_define_method(mrb, f, "to_s", false_to_s, MRB_ARGS_NONE()); /* 15.2.6.3.3 */
|
---|
| 295 | mrb_define_method(mrb, f, "|", false_or, MRB_ARGS_REQ(1)); /* 15.2.6.3.4 */
|
---|
| 296 | mrb_define_method(mrb, f, "inspect", false_to_s, MRB_ARGS_NONE());
|
---|
| 297 | }
|
---|
| 298 |
|
---|
| 299 | static mrb_value
|
---|
| 300 | convert_type(mrb_state *mrb, mrb_value val, const char *tname, const char *method, mrb_bool raise)
|
---|
| 301 | {
|
---|
| 302 | mrb_sym m = 0;
|
---|
| 303 |
|
---|
| 304 | m = mrb_intern_cstr(mrb, method);
|
---|
| 305 | if (!mrb_respond_to(mrb, val, m)) {
|
---|
| 306 | if (raise) {
|
---|
[439] | 307 | mrb_raisef(mrb, E_TYPE_ERROR, "can't convert %Y into %s", val, tname);
|
---|
[270] | 308 | }
|
---|
| 309 | return mrb_nil_value();
|
---|
| 310 | }
|
---|
| 311 | return mrb_funcall_argv(mrb, val, m, 0, 0);
|
---|
| 312 | }
|
---|
| 313 |
|
---|
| 314 | MRB_API mrb_value
|
---|
| 315 | mrb_convert_type(mrb_state *mrb, mrb_value val, enum mrb_vtype type, const char *tname, const char *method)
|
---|
| 316 | {
|
---|
| 317 | mrb_value v;
|
---|
| 318 |
|
---|
| 319 | if (mrb_type(val) == type) return val;
|
---|
| 320 | v = convert_type(mrb, val, tname, method, TRUE);
|
---|
| 321 | if (mrb_type(v) != type) {
|
---|
[439] | 322 | mrb_raisef(mrb, E_TYPE_ERROR, "%v cannot be converted to %s by #%s", val, tname, method);
|
---|
[270] | 323 | }
|
---|
| 324 | return v;
|
---|
| 325 | }
|
---|
| 326 |
|
---|
| 327 | MRB_API mrb_value
|
---|
| 328 | mrb_check_convert_type(mrb_state *mrb, mrb_value val, enum mrb_vtype type, const char *tname, const char *method)
|
---|
| 329 | {
|
---|
| 330 | mrb_value v;
|
---|
| 331 |
|
---|
[331] | 332 | if (mrb_type(val) == type && type != MRB_TT_DATA && type != MRB_TT_ISTRUCT) return val;
|
---|
[270] | 333 | v = convert_type(mrb, val, tname, method, FALSE);
|
---|
| 334 | if (mrb_nil_p(v) || mrb_type(v) != type) return mrb_nil_value();
|
---|
| 335 | return v;
|
---|
| 336 | }
|
---|
| 337 |
|
---|
| 338 | static const struct types {
|
---|
| 339 | unsigned char type;
|
---|
| 340 | const char *name;
|
---|
| 341 | } builtin_types[] = {
|
---|
| 342 | /* {MRB_TT_NIL, "nil"}, */
|
---|
| 343 | {MRB_TT_FALSE, "false"},
|
---|
| 344 | {MRB_TT_TRUE, "true"},
|
---|
| 345 | {MRB_TT_FIXNUM, "Fixnum"},
|
---|
| 346 | {MRB_TT_SYMBOL, "Symbol"}, /* :symbol */
|
---|
| 347 | {MRB_TT_MODULE, "Module"},
|
---|
| 348 | {MRB_TT_OBJECT, "Object"},
|
---|
| 349 | {MRB_TT_CLASS, "Class"},
|
---|
| 350 | {MRB_TT_ICLASS, "iClass"}, /* internal use: mixed-in module holder */
|
---|
| 351 | {MRB_TT_SCLASS, "SClass"},
|
---|
| 352 | {MRB_TT_PROC, "Proc"},
|
---|
[439] | 353 | #ifndef MRB_WITHOUT_FLOAT
|
---|
[270] | 354 | {MRB_TT_FLOAT, "Float"},
|
---|
[439] | 355 | #endif
|
---|
[270] | 356 | {MRB_TT_ARRAY, "Array"},
|
---|
| 357 | {MRB_TT_HASH, "Hash"},
|
---|
| 358 | {MRB_TT_STRING, "String"},
|
---|
| 359 | {MRB_TT_RANGE, "Range"},
|
---|
| 360 | /* {MRB_TT_BIGNUM, "Bignum"}, */
|
---|
| 361 | {MRB_TT_FILE, "File"},
|
---|
| 362 | {MRB_TT_DATA, "Data"}, /* internal use: wrapped C pointers */
|
---|
| 363 | /* {MRB_TT_VARMAP, "Varmap"}, */ /* internal use: dynamic variables */
|
---|
| 364 | /* {MRB_TT_NODE, "Node"}, */ /* internal use: syntax tree node */
|
---|
| 365 | /* {MRB_TT_UNDEF, "undef"}, */ /* internal use: #undef; should not happen */
|
---|
[331] | 366 | {MRB_TT_MAXDEFINE, 0}
|
---|
[270] | 367 | };
|
---|
| 368 |
|
---|
| 369 | MRB_API void
|
---|
| 370 | mrb_check_type(mrb_state *mrb, mrb_value x, enum mrb_vtype t)
|
---|
| 371 | {
|
---|
| 372 | const struct types *type = builtin_types;
|
---|
| 373 | enum mrb_vtype xt;
|
---|
| 374 |
|
---|
| 375 | xt = mrb_type(x);
|
---|
[331] | 376 | if ((xt != t) || (xt == MRB_TT_DATA) || (xt == MRB_TT_ISTRUCT)) {
|
---|
[270] | 377 | while (type->type < MRB_TT_MAXDEFINE) {
|
---|
| 378 | if (type->type == t) {
|
---|
| 379 | const char *etype;
|
---|
| 380 |
|
---|
| 381 | if (mrb_nil_p(x)) {
|
---|
| 382 | etype = "nil";
|
---|
| 383 | }
|
---|
| 384 | else if (mrb_fixnum_p(x)) {
|
---|
| 385 | etype = "Fixnum";
|
---|
| 386 | }
|
---|
[439] | 387 | else if (mrb_symbol_p(x)) {
|
---|
[270] | 388 | etype = "Symbol";
|
---|
| 389 | }
|
---|
| 390 | else if (mrb_immediate_p(x)) {
|
---|
| 391 | etype = RSTRING_PTR(mrb_obj_as_string(mrb, x));
|
---|
| 392 | }
|
---|
| 393 | else {
|
---|
| 394 | etype = mrb_obj_classname(mrb, x);
|
---|
| 395 | }
|
---|
[439] | 396 | mrb_raisef(mrb, E_TYPE_ERROR, "wrong argument type %s (expected %s)",
|
---|
| 397 | etype, type->name);
|
---|
[270] | 398 | }
|
---|
| 399 | type++;
|
---|
| 400 | }
|
---|
[439] | 401 | mrb_raisef(mrb, E_TYPE_ERROR, "unknown type %d (%d given)", t, mrb_type(x));
|
---|
[270] | 402 | }
|
---|
| 403 | }
|
---|
| 404 |
|
---|
| 405 | /* 15.3.1.3.46 */
|
---|
| 406 | /*
|
---|
| 407 | * call-seq:
|
---|
| 408 | * obj.to_s => string
|
---|
| 409 | *
|
---|
| 410 | * Returns a string representing <i>obj</i>. The default
|
---|
| 411 | * <code>to_s</code> prints the object's class and an encoding of the
|
---|
| 412 | * object id. As a special case, the top-level object that is the
|
---|
| 413 | * initial execution context of Ruby programs returns "main."
|
---|
| 414 | */
|
---|
| 415 |
|
---|
| 416 | MRB_API mrb_value
|
---|
| 417 | mrb_any_to_s(mrb_state *mrb, mrb_value obj)
|
---|
| 418 | {
|
---|
[439] | 419 | mrb_value str = mrb_str_new_capa(mrb, 20);
|
---|
[270] | 420 | const char *cname = mrb_obj_classname(mrb, obj);
|
---|
| 421 |
|
---|
| 422 | mrb_str_cat_lit(mrb, str, "#<");
|
---|
| 423 | mrb_str_cat_cstr(mrb, str, cname);
|
---|
[439] | 424 | if (!mrb_immediate_p(obj)) {
|
---|
| 425 | mrb_str_cat_lit(mrb, str, ":");
|
---|
| 426 | mrb_str_cat_str(mrb, str, mrb_ptr_to_str(mrb, mrb_ptr(obj)));
|
---|
| 427 | }
|
---|
[270] | 428 | mrb_str_cat_lit(mrb, str, ">");
|
---|
| 429 |
|
---|
| 430 | return str;
|
---|
| 431 | }
|
---|
| 432 |
|
---|
| 433 | /*
|
---|
| 434 | * call-seq:
|
---|
| 435 | * obj.is_a?(class) => true or false
|
---|
| 436 | * obj.kind_of?(class) => true or false
|
---|
| 437 | *
|
---|
| 438 | * Returns <code>true</code> if <i>class</i> is the class of
|
---|
| 439 | * <i>obj</i>, or if <i>class</i> is one of the superclasses of
|
---|
| 440 | * <i>obj</i> or modules included in <i>obj</i>.
|
---|
| 441 | *
|
---|
| 442 | * module M; end
|
---|
| 443 | * class A
|
---|
| 444 | * include M
|
---|
| 445 | * end
|
---|
| 446 | * class B < A; end
|
---|
| 447 | * class C < B; end
|
---|
| 448 | * b = B.new
|
---|
| 449 | * b.instance_of? A #=> false
|
---|
| 450 | * b.instance_of? B #=> true
|
---|
| 451 | * b.instance_of? C #=> false
|
---|
| 452 | * b.instance_of? M #=> false
|
---|
| 453 | * b.kind_of? A #=> true
|
---|
| 454 | * b.kind_of? B #=> true
|
---|
| 455 | * b.kind_of? C #=> false
|
---|
| 456 | * b.kind_of? M #=> true
|
---|
| 457 | */
|
---|
| 458 |
|
---|
| 459 | MRB_API mrb_bool
|
---|
| 460 | mrb_obj_is_kind_of(mrb_state *mrb, mrb_value obj, struct RClass *c)
|
---|
| 461 | {
|
---|
| 462 | struct RClass *cl = mrb_class(mrb, obj);
|
---|
| 463 |
|
---|
| 464 | switch (c->tt) {
|
---|
| 465 | case MRB_TT_MODULE:
|
---|
| 466 | case MRB_TT_CLASS:
|
---|
| 467 | case MRB_TT_ICLASS:
|
---|
[331] | 468 | case MRB_TT_SCLASS:
|
---|
[270] | 469 | break;
|
---|
| 470 |
|
---|
| 471 | default:
|
---|
| 472 | mrb_raise(mrb, E_TYPE_ERROR, "class or module required");
|
---|
| 473 | }
|
---|
| 474 |
|
---|
| 475 | MRB_CLASS_ORIGIN(c);
|
---|
| 476 | while (cl) {
|
---|
| 477 | if (cl == c || cl->mt == c->mt)
|
---|
| 478 | return TRUE;
|
---|
| 479 | cl = cl->super;
|
---|
| 480 | }
|
---|
| 481 | return FALSE;
|
---|
| 482 | }
|
---|
| 483 |
|
---|
[439] | 484 | MRB_API mrb_value
|
---|
| 485 | mrb_to_int(mrb_state *mrb, mrb_value val)
|
---|
[270] | 486 | {
|
---|
| 487 |
|
---|
[439] | 488 | if (!mrb_fixnum_p(val)) {
|
---|
| 489 | #ifndef MRB_WITHOUT_FLOAT
|
---|
| 490 | if (mrb_float_p(val)) {
|
---|
| 491 | return mrb_flo_to_fixnum(mrb, val);
|
---|
| 492 | }
|
---|
| 493 | #endif
|
---|
| 494 | mrb_raisef(mrb, E_TYPE_ERROR, "can't convert %Y to Integer", val);
|
---|
[270] | 495 | }
|
---|
[439] | 496 | return val;
|
---|
[270] | 497 | }
|
---|
| 498 |
|
---|
| 499 | MRB_API mrb_value
|
---|
[439] | 500 | mrb_convert_to_integer(mrb_state *mrb, mrb_value val, mrb_int base)
|
---|
[270] | 501 | {
|
---|
| 502 | mrb_value tmp;
|
---|
| 503 |
|
---|
| 504 | if (mrb_nil_p(val)) {
|
---|
| 505 | if (base != 0) goto arg_error;
|
---|
[439] | 506 | mrb_raise(mrb, E_TYPE_ERROR, "can't convert nil into Integer");
|
---|
[270] | 507 | }
|
---|
| 508 | switch (mrb_type(val)) {
|
---|
[439] | 509 | #ifndef MRB_WITHOUT_FLOAT
|
---|
[270] | 510 | case MRB_TT_FLOAT:
|
---|
| 511 | if (base != 0) goto arg_error;
|
---|
| 512 | return mrb_flo_to_fixnum(mrb, val);
|
---|
[439] | 513 | #endif
|
---|
[270] | 514 |
|
---|
| 515 | case MRB_TT_FIXNUM:
|
---|
| 516 | if (base != 0) goto arg_error;
|
---|
| 517 | return val;
|
---|
| 518 |
|
---|
| 519 | case MRB_TT_STRING:
|
---|
| 520 | string_conv:
|
---|
| 521 | return mrb_str_to_inum(mrb, val, base, TRUE);
|
---|
| 522 |
|
---|
| 523 | default:
|
---|
| 524 | break;
|
---|
| 525 | }
|
---|
| 526 | if (base != 0) {
|
---|
| 527 | tmp = mrb_check_string_type(mrb, val);
|
---|
| 528 | if (!mrb_nil_p(tmp)) {
|
---|
[331] | 529 | val = tmp;
|
---|
[270] | 530 | goto string_conv;
|
---|
| 531 | }
|
---|
| 532 | arg_error:
|
---|
| 533 | mrb_raise(mrb, E_ARGUMENT_ERROR, "base specified for non string value");
|
---|
| 534 | }
|
---|
[439] | 535 | /* to raise TypeError */
|
---|
| 536 | return mrb_to_int(mrb, val);
|
---|
[270] | 537 | }
|
---|
| 538 |
|
---|
| 539 | MRB_API mrb_value
|
---|
| 540 | mrb_Integer(mrb_state *mrb, mrb_value val)
|
---|
| 541 | {
|
---|
| 542 | return mrb_convert_to_integer(mrb, val, 0);
|
---|
| 543 | }
|
---|
| 544 |
|
---|
[439] | 545 | #ifndef MRB_WITHOUT_FLOAT
|
---|
[270] | 546 | MRB_API mrb_value
|
---|
| 547 | mrb_Float(mrb_state *mrb, mrb_value val)
|
---|
| 548 | {
|
---|
| 549 | if (mrb_nil_p(val)) {
|
---|
| 550 | mrb_raise(mrb, E_TYPE_ERROR, "can't convert nil into Float");
|
---|
| 551 | }
|
---|
| 552 | switch (mrb_type(val)) {
|
---|
| 553 | case MRB_TT_FIXNUM:
|
---|
| 554 | return mrb_float_value(mrb, (mrb_float)mrb_fixnum(val));
|
---|
| 555 |
|
---|
| 556 | case MRB_TT_FLOAT:
|
---|
| 557 | return val;
|
---|
| 558 |
|
---|
| 559 | case MRB_TT_STRING:
|
---|
| 560 | return mrb_float_value(mrb, mrb_str_to_dbl(mrb, val, TRUE));
|
---|
| 561 |
|
---|
| 562 | default:
|
---|
| 563 | return mrb_convert_type(mrb, val, MRB_TT_FLOAT, "Float", "to_f");
|
---|
| 564 | }
|
---|
| 565 | }
|
---|
[439] | 566 | #endif
|
---|
[270] | 567 |
|
---|
| 568 | MRB_API mrb_value
|
---|
[439] | 569 | mrb_to_str(mrb_state *mrb, mrb_value val)
|
---|
| 570 | {
|
---|
| 571 | return mrb_ensure_string_type(mrb, val);
|
---|
| 572 | }
|
---|
| 573 |
|
---|
| 574 | /* obsolete: use mrb_ensure_string_type() instead */
|
---|
| 575 | MRB_API mrb_value
|
---|
| 576 | mrb_string_type(mrb_state *mrb, mrb_value str)
|
---|
| 577 | {
|
---|
| 578 | return mrb_ensure_string_type(mrb, str);
|
---|
| 579 | }
|
---|
| 580 |
|
---|
| 581 | MRB_API mrb_value
|
---|
| 582 | mrb_ensure_string_type(mrb_state *mrb, mrb_value str)
|
---|
| 583 | {
|
---|
| 584 | if (!mrb_string_p(str)) {
|
---|
| 585 | mrb_raisef(mrb, E_TYPE_ERROR, "%Y cannot be converted to String", str);
|
---|
| 586 | }
|
---|
| 587 | return str;
|
---|
| 588 | }
|
---|
| 589 |
|
---|
| 590 | MRB_API mrb_value
|
---|
| 591 | mrb_check_string_type(mrb_state *mrb, mrb_value str)
|
---|
| 592 | {
|
---|
| 593 | if (!mrb_string_p(str)) return mrb_nil_value();
|
---|
| 594 | return str;
|
---|
| 595 | }
|
---|
| 596 |
|
---|
| 597 | MRB_API mrb_value
|
---|
| 598 | mrb_ensure_array_type(mrb_state *mrb, mrb_value ary)
|
---|
| 599 | {
|
---|
| 600 | if (!mrb_array_p(ary)) {
|
---|
| 601 | mrb_raisef(mrb, E_TYPE_ERROR, "%Y cannot be converted to Array", ary);
|
---|
| 602 | }
|
---|
| 603 | return ary;
|
---|
| 604 | }
|
---|
| 605 |
|
---|
| 606 | MRB_API mrb_value
|
---|
| 607 | mrb_check_array_type(mrb_state *mrb, mrb_value ary)
|
---|
| 608 | {
|
---|
| 609 | if (!mrb_array_p(ary)) return mrb_nil_value();
|
---|
| 610 | return ary;
|
---|
| 611 | }
|
---|
| 612 |
|
---|
| 613 | MRB_API mrb_value
|
---|
| 614 | mrb_ensure_hash_type(mrb_state *mrb, mrb_value hash)
|
---|
| 615 | {
|
---|
| 616 | if (!mrb_hash_p(hash)) {
|
---|
| 617 | mrb_raisef(mrb, E_TYPE_ERROR, "%Y cannot be converted to Hash", hash);
|
---|
| 618 | }
|
---|
| 619 | return hash;
|
---|
| 620 | }
|
---|
| 621 |
|
---|
| 622 | MRB_API mrb_value
|
---|
| 623 | mrb_check_hash_type(mrb_state *mrb, mrb_value hash)
|
---|
| 624 | {
|
---|
| 625 | if (!mrb_hash_p(hash)) return mrb_nil_value();
|
---|
| 626 | return hash;
|
---|
| 627 | }
|
---|
| 628 |
|
---|
| 629 | MRB_API mrb_value
|
---|
[270] | 630 | mrb_inspect(mrb_state *mrb, mrb_value obj)
|
---|
| 631 | {
|
---|
| 632 | return mrb_obj_as_string(mrb, mrb_funcall(mrb, obj, "inspect", 0));
|
---|
| 633 | }
|
---|
| 634 |
|
---|
| 635 | MRB_API mrb_bool
|
---|
| 636 | mrb_eql(mrb_state *mrb, mrb_value obj1, mrb_value obj2)
|
---|
| 637 | {
|
---|
| 638 | if (mrb_obj_eq(mrb, obj1, obj2)) return TRUE;
|
---|
| 639 | return mrb_test(mrb_funcall(mrb, obj1, "eql?", 1, obj2));
|
---|
| 640 | }
|
---|