Ruby: vm_args.c Source File

Ruby 3.4.4p34 (2025-05-14 revision a38531fd3f617bf734ef7d6c595325f69985ea1d)

vm_args.c
1/**********************************************************************
2
3 vm_args.c - process method call arguments.
4
5 $Author$
6
7 Copyright (C) 2014- Yukihiro Matsumoto
8
9**********************************************************************/
10
11NORETURN(static void raise_argument_error(rb_execution_context_t *ec, const rb_iseq_t *iseq, const VALUE exc));
12NORETURN(static void argument_arity_error(rb_execution_context_t *ec, const rb_iseq_t *iseq, const int miss_argc, const int min_argc, const int max_argc));
13NORETURN(static void argument_kw_error(rb_execution_context_t *ec, const rb_iseq_t *iseq, const char *error, const VALUE keys));
14 VALUE rb_keyword_error_new(const char *error, VALUE keys); /* class.c */
15static VALUE method_missing(rb_execution_context_t *ec, VALUE obj, ID id, int argc, const VALUE *argv,
16 enum method_missing_reason call_status, int kw_splat);
17const rb_callable_method_entry_t *rb_resolve_refined_method_callable(VALUE refinements, const rb_callable_method_entry_t *me);
18
19 struct args_info {
20 /* basic args info */
21 VALUE *argv;
22 int argc;
23
24 /* additional args info */
25 int rest_index;
26 int rest_dupped;
27 const struct rb_callinfo_kwarg *kw_arg;
28 VALUE *kw_argv;
29 VALUE rest;
30};
31
32enum arg_setup_type {
33 arg_setup_method,
34 arg_setup_block
35};
36
37static inline void
38arg_rest_dup(struct args_info *args)
39{
40 if (!args->rest_dupped) {
41 args->rest = rb_ary_dup(args->rest);
42 args->rest_dupped = TRUE;
43 }
44}
45
46static inline int
47args_argc(struct args_info *args)
48{
49 if (args->rest == Qfalse) {
50 return args->argc;
51 }
52 else {
53 return args->argc + RARRAY_LENINT(args->rest) - args->rest_index;
54 }
55}
56
57static inline void
58args_extend(struct args_info *args, const int min_argc)
59{
60 int i;
61
62 if (args->rest) {
63 arg_rest_dup(args);
64 VM_ASSERT(args->rest_index == 0);
65 for (i=args->argc + RARRAY_LENINT(args->rest); i<min_argc; i++) {
66 rb_ary_push(args->rest, Qnil);
67 }
68 }
69 else {
70 for (i=args->argc; i<min_argc; i++) {
71 args->argv[args->argc++] = Qnil;
72 }
73 }
74}
75
76static inline void
77args_reduce(struct args_info *args, int over_argc)
78{
79 if (args->rest) {
80 const long len = RARRAY_LEN(args->rest);
81
82 if (len > over_argc) {
83 arg_rest_dup(args);
84 rb_ary_resize(args->rest, len - over_argc);
85 return;
86 }
87 else {
88 args->rest = Qfalse;
89 over_argc -= len;
90 }
91 }
92
93 VM_ASSERT(args->argc >= over_argc);
94 args->argc -= over_argc;
95}
96
97static inline int
98args_check_block_arg0(struct args_info *args)
99{
100 VALUE ary = Qnil;
101
102 if (args->rest && RARRAY_LEN(args->rest) == 1) {
103 VALUE arg0 = RARRAY_AREF(args->rest, 0);
104 ary = rb_check_array_type(arg0);
105 }
106 else if (args->argc == 1) {
107 VALUE arg0 = args->argv[0];
108 ary = rb_check_array_type(arg0);
109 args->argv[0] = arg0; /* see: https://bugs.ruby-lang.org/issues/8484 */
110 }
111
112 if (!NIL_P(ary)) {
113 args->rest = ary;
114 args->rest_index = 0;
115 args->argc = 0;
116 return TRUE;
117 }
118
119 return FALSE;
120}
121
122static inline void
123args_copy(struct args_info *args)
124{
125 if (args->rest != Qfalse) {
126 int argc = args->argc;
127 args->argc = 0;
128 arg_rest_dup(args);
129
130 /*
131 * argv: [m0, m1, m2, m3]
132 * rest: [a0, a1, a2, a3, a4, a5]
133 * ^
134 * rest_index
135 *
136 * #=> first loop
137 *
138 * argv: [m0, m1]
139 * rest: [m2, m3, a2, a3, a4, a5]
140 * ^
141 * rest_index
142 *
143 * #=> 2nd loop
144 *
145 * argv: [] (argc == 0)
146 * rest: [m0, m1, m2, m3, a2, a3, a4, a5]
147 * ^
148 * rest_index
149 */
150 while (args->rest_index > 0 && argc > 0) {
151 RARRAY_ASET(args->rest, --args->rest_index, args->argv[--argc]);
152 }
153 while (argc > 0) {
154 rb_ary_unshift(args->rest, args->argv[--argc]);
155 }
156 }
157 else if (args->argc > 0) {
158 args->rest = rb_ary_new_from_values(args->argc, args->argv);
159 args->rest_index = 0;
160 args->rest_dupped = TRUE;
161 args->argc = 0;
162 }
163}
164
165static inline const VALUE *
166args_rest_argv(struct args_info *args)
167{
168 return RARRAY_CONST_PTR(args->rest) + args->rest_index;
169}
170
171static inline VALUE
172args_rest_array(struct args_info *args)
173{
174 VALUE ary;
175
176 if (args->rest) {
177 ary = rb_ary_behead(args->rest, args->rest_index);
178 args->rest_index = 0;
179 args->rest = 0;
180 }
181 else {
182 ary = rb_ary_new();
183 }
184 return ary;
185}
186
187static int
188args_kw_argv_to_hash(struct args_info *args)
189{
190 const struct rb_callinfo_kwarg *kw_arg = args->kw_arg;
191 const VALUE *const passed_keywords = kw_arg->keywords;
192 const int kw_len = kw_arg->keyword_len;
193 VALUE h = rb_hash_new_with_size(kw_len);
194 const int kw_start = args->argc - kw_len;
195 const VALUE * const kw_argv = args->argv + kw_start;
196 int i;
197
198 args->argc = kw_start + 1;
199 for (i=0; i<kw_len; i++) {
200 rb_hash_aset(h, passed_keywords[i], kw_argv[i]);
201 }
202
203 args->argv[args->argc - 1] = h;
204
205 return args->argc;
206}
207
208static inline void
209args_setup_lead_parameters(struct args_info *args, int argc, VALUE *locals)
210{
211 if (args->argc >= argc) {
212 /* do noting */
213 args->argc -= argc;
214 args->argv += argc;
215 }
216 else {
217 int i, j;
218 const VALUE *argv = args_rest_argv(args);
219
220 for (i=args->argc, j=0; i<argc; i++, j++) {
221 locals[i] = argv[j];
222 }
223 args->rest_index += argc - args->argc;
224 args->argc = 0;
225 }
226}
227
228static inline void
229args_setup_post_parameters(struct args_info *args, int argc, VALUE *locals)
230{
231 long len;
232 len = RARRAY_LEN(args->rest);
233 MEMCPY(locals, RARRAY_CONST_PTR(args->rest) + len - argc, VALUE, argc);
234 rb_ary_resize(args->rest, len - argc);
235}
236
237static inline int
238args_setup_opt_parameters(struct args_info *args, int opt_max, VALUE *locals)
239{
240 int i;
241
242 if (args->argc >= opt_max) {
243 args->argc -= opt_max;
244 args->argv += opt_max;
245 i = opt_max;
246 }
247 else {
248 int j;
249 i = args->argc;
250 args->argc = 0;
251
252 if (args->rest) {
253 int len = RARRAY_LENINT(args->rest);
254 const VALUE *argv = RARRAY_CONST_PTR(args->rest);
255
256 for (; i<opt_max && args->rest_index < len; i++, args->rest_index++) {
257 locals[i] = argv[args->rest_index];
258 }
259 }
260
261 /* initialize by nil */
262 for (j=i; j<opt_max; j++) {
263 locals[j] = Qnil;
264 }
265 }
266
267 return i;
268}
269
270static inline void
271args_setup_rest_parameter(struct args_info *args, VALUE *locals)
272{
273 *locals = args_rest_array(args);
274}
275
276static VALUE
277make_unknown_kw_hash(const VALUE *passed_keywords, int passed_keyword_len, const VALUE *kw_argv)
278{
279 int i;
280 VALUE obj = rb_ary_hidden_new(1);
281
282 for (i=0; i<passed_keyword_len; i++) {
283 if (!UNDEF_P(kw_argv[i])) {
284 rb_ary_push(obj, passed_keywords[i]);
285 }
286 }
287 return obj;
288}
289
290static VALUE
291make_rest_kw_hash(const VALUE *passed_keywords, int passed_keyword_len, const VALUE *kw_argv)
292{
293 int i;
294 VALUE obj = rb_hash_new_with_size(passed_keyword_len);
295
296 for (i=0; i<passed_keyword_len; i++) {
297 if (!UNDEF_P(kw_argv[i])) {
298 rb_hash_aset(obj, passed_keywords[i], kw_argv[i]);
299 }
300 }
301 return obj;
302}
303
304static inline int
305args_setup_kw_parameters_lookup(const ID key, VALUE *ptr, const VALUE *const passed_keywords, VALUE *passed_values, const int passed_keyword_len)
306{
307 int i;
308 const VALUE keyname = ID2SYM(key);
309
310 for (i=0; i<passed_keyword_len; i++) {
311 if (keyname == passed_keywords[i]) {
312 *ptr = passed_values[i];
313 passed_values[i] = Qundef;
314 return TRUE;
315 }
316 }
317
318 return FALSE;
319}
320
321#define KW_SPECIFIED_BITS_MAX (32-1) /* TODO: 32 -> Fixnum's max bits */
322
323static void
324args_setup_kw_parameters(rb_execution_context_t *const ec, const rb_iseq_t *const iseq,
325 VALUE *const passed_values, const int passed_keyword_len, const VALUE *const passed_keywords,
326 VALUE *const locals)
327{
328 const ID *acceptable_keywords = ISEQ_BODY(iseq)->param.keyword->table;
329 const int req_key_num = ISEQ_BODY(iseq)->param.keyword->required_num;
330 const int key_num = ISEQ_BODY(iseq)->param.keyword->num;
331 const VALUE * const default_values = ISEQ_BODY(iseq)->param.keyword->default_values;
332 VALUE missing = 0;
333 int i, di, found = 0;
334 int unspecified_bits = 0;
335 VALUE unspecified_bits_value = Qnil;
336
337 for (i=0; i<req_key_num; i++) {
338 ID key = acceptable_keywords[i];
339 if (args_setup_kw_parameters_lookup(key, &locals[i], passed_keywords, passed_values, passed_keyword_len)) {
340 found++;
341 }
342 else {
343 if (!missing) missing = rb_ary_hidden_new(1);
344 rb_ary_push(missing, ID2SYM(key));
345 }
346 }
347
348 if (missing) argument_kw_error(ec, iseq, "missing", missing);
349
350 for (di=0; i<key_num; i++, di++) {
351 if (args_setup_kw_parameters_lookup(acceptable_keywords[i], &locals[i], passed_keywords, passed_values, passed_keyword_len)) {
352 found++;
353 }
354 else {
355 if (UNDEF_P(default_values[di])) {
356 locals[i] = Qnil;
357
358 if (LIKELY(i < KW_SPECIFIED_BITS_MAX)) {
359 unspecified_bits |= 0x01 << di;
360 }
361 else {
362 if (NIL_P(unspecified_bits_value)) {
363 /* fixnum -> hash */
364 int j;
365 unspecified_bits_value = rb_hash_new();
366
367 for (j=0; j<KW_SPECIFIED_BITS_MAX; j++) {
368 if (unspecified_bits & (0x01 << j)) {
369 rb_hash_aset(unspecified_bits_value, INT2FIX(j), Qtrue);
370 }
371 }
372 }
373 rb_hash_aset(unspecified_bits_value, INT2FIX(di), Qtrue);
374 }
375 }
376 else {
377 locals[i] = default_values[di];
378 }
379 }
380 }
381
382 if (ISEQ_BODY(iseq)->param.flags.has_kwrest) {
383 const int rest_hash_index = key_num + 1;
384 locals[rest_hash_index] = make_rest_kw_hash(passed_keywords, passed_keyword_len, passed_values);
385 }
386 else {
387 if (found != passed_keyword_len) {
388 VALUE keys = make_unknown_kw_hash(passed_keywords, passed_keyword_len, passed_values);
389 argument_kw_error(ec, iseq, "unknown", keys);
390 }
391 }
392
393 if (NIL_P(unspecified_bits_value)) {
394 unspecified_bits_value = INT2FIX(unspecified_bits);
395 }
396 locals[key_num] = unspecified_bits_value;
397}
398
399static void
400args_setup_kw_parameters_from_kwsplat(rb_execution_context_t *const ec, const rb_iseq_t *const iseq,
401 VALUE keyword_hash, VALUE *const locals, bool remove_hash_value)
402{
403 const ID *acceptable_keywords = ISEQ_BODY(iseq)->param.keyword->table;
404 const int req_key_num = ISEQ_BODY(iseq)->param.keyword->required_num;
405 const int key_num = ISEQ_BODY(iseq)->param.keyword->num;
406 const VALUE * const default_values = ISEQ_BODY(iseq)->param.keyword->default_values;
407 VALUE missing = 0;
408 int i, di;
409 int unspecified_bits = 0;
410 size_t keyword_size = RHASH_SIZE(keyword_hash);
411 VALUE unspecified_bits_value = Qnil;
412
413 for (i=0; i<req_key_num; i++) {
414 VALUE key = ID2SYM(acceptable_keywords[i]);
415 VALUE value;
416 if (remove_hash_value) {
417 value = rb_hash_delete_entry(keyword_hash, key);
418 }
419 else {
420 value = rb_hash_lookup2(keyword_hash, key, Qundef);
421 }
422
423 if (!UNDEF_P(value)) {
424 keyword_size--;
425 locals[i] = value;
426 }
427 else {
428 if (!missing) missing = rb_ary_hidden_new(1);
429 rb_ary_push(missing, key);
430 }
431 }
432
433 if (missing) argument_kw_error(ec, iseq, "missing", missing);
434
435 for (di=0; i<key_num; i++, di++) {
436 VALUE key = ID2SYM(acceptable_keywords[i]);
437 VALUE value;
438 if (remove_hash_value) {
439 value = rb_hash_delete_entry(keyword_hash, key);
440 }
441 else {
442 value = rb_hash_lookup2(keyword_hash, key, Qundef);
443 }
444
445 if (!UNDEF_P(value)) {
446 keyword_size--;
447 locals[i] = value;
448 }
449 else {
450 if (UNDEF_P(default_values[di])) {
451 locals[i] = Qnil;
452
453 if (LIKELY(i < KW_SPECIFIED_BITS_MAX)) {
454 unspecified_bits |= 0x01 << di;
455 }
456 else {
457 if (NIL_P(unspecified_bits_value)) {
458 /* fixnum -> hash */
459 int j;
460 unspecified_bits_value = rb_hash_new();
461
462 for (j=0; j<KW_SPECIFIED_BITS_MAX; j++) {
463 if (unspecified_bits & (0x01 << j)) {
464 rb_hash_aset(unspecified_bits_value, INT2FIX(j), Qtrue);
465 }
466 }
467 }
468 rb_hash_aset(unspecified_bits_value, INT2FIX(di), Qtrue);
469 }
470 }
471 else {
472 locals[i] = default_values[di];
473 }
474 }
475 }
476
477 if (ISEQ_BODY(iseq)->param.flags.has_kwrest) {
478 const int rest_hash_index = key_num + 1;
479 locals[rest_hash_index] = keyword_hash;
480 }
481 else {
482 if (!remove_hash_value) {
483 if (keyword_size != 0) {
484 /* Recurse with duplicated keyword hash in remove mode.
485 * This is simpler than writing code to check which entries in the hash do not match.
486 * This will raise an exception, so the additional performance impact shouldn't be material.
487 */
488 args_setup_kw_parameters_from_kwsplat(ec, iseq, rb_hash_dup(keyword_hash), locals, true);
489 }
490 }
491 else if (!RHASH_EMPTY_P(keyword_hash)) {
492 argument_kw_error(ec, iseq, "unknown", rb_hash_keys(keyword_hash));
493 }
494 }
495
496 if (NIL_P(unspecified_bits_value)) {
497 unspecified_bits_value = INT2FIX(unspecified_bits);
498 }
499 locals[key_num] = unspecified_bits_value;
500}
501
502static inline void
503args_setup_kw_rest_parameter(VALUE keyword_hash, VALUE *locals, int kw_flag, bool anon_kwrest)
504{
505 if (NIL_P(keyword_hash)) {
506 if (!anon_kwrest) {
507 keyword_hash = rb_hash_new();
508 }
509 }
510 else if (!(kw_flag & VM_CALL_KW_SPLAT_MUT)) {
511 keyword_hash = rb_hash_dup(keyword_hash);
512 }
513 locals[0] = keyword_hash;
514}
515
516static inline void
517args_setup_block_parameter(const rb_execution_context_t *ec, struct rb_calling_info *calling, VALUE *locals)
518{
519 VALUE block_handler = calling->block_handler;
520 *locals = rb_vm_bh_to_procval(ec, block_handler);
521}
522
523static inline int
524ignore_keyword_hash_p(VALUE keyword_hash, const rb_iseq_t * const iseq, unsigned int * kw_flag, VALUE * converted_keyword_hash)
525{
526 if (keyword_hash == Qnil) {
527 goto ignore;
528 }
529 else if (!RB_TYPE_P(keyword_hash, T_HASH)) {
530 keyword_hash = rb_to_hash_type(keyword_hash);
531 }
532 else if (UNLIKELY(ISEQ_BODY(iseq)->param.flags.anon_kwrest)) {
533 if (!ISEQ_BODY(iseq)->param.flags.has_kw) {
534 *kw_flag |= VM_CALL_KW_SPLAT_MUT;
535 }
536 }
537
538 if (RHASH_EMPTY_P(keyword_hash) && !ISEQ_BODY(iseq)->param.flags.has_kwrest) {
539 goto ignore;
540 }
541
542 if (!(*kw_flag & VM_CALL_KW_SPLAT_MUT) &&
543 (ISEQ_BODY(iseq)->param.flags.has_kwrest ||
544 ISEQ_BODY(iseq)->param.flags.ruby2_keywords)) {
545 *kw_flag |= VM_CALL_KW_SPLAT_MUT;
546 keyword_hash = rb_hash_dup(keyword_hash);
547 }
548 *converted_keyword_hash = keyword_hash;
549
550 if (!(ISEQ_BODY(iseq)->param.flags.has_kw) &&
551 !(ISEQ_BODY(iseq)->param.flags.has_kwrest) &&
552 RHASH_EMPTY_P(keyword_hash)) {
553 ignore:
554 *kw_flag &= ~(VM_CALL_KW_SPLAT | VM_CALL_KW_SPLAT_MUT);
555 return 1;
556 }
557 else {
558 return 0;
559 }
560}
561
562static VALUE
563check_kwrestarg(VALUE keyword_hash, unsigned int *kw_flag)
564{
565 if (!(*kw_flag & VM_CALL_KW_SPLAT_MUT)) {
566 *kw_flag |= VM_CALL_KW_SPLAT_MUT;
567 return rb_hash_dup(keyword_hash);
568 }
569 else {
570 return keyword_hash;
571 }
572}
573
574static void
575flatten_rest_args(rb_execution_context_t * const ec, struct args_info *args, VALUE * const locals, unsigned int *ci_flag)
576{
577 const VALUE *argv = RARRAY_CONST_PTR(args->rest);
578 int j, i=args->argc, rest_len = RARRAY_LENINT(args->rest)-1;
579 args->argc += rest_len;
580 if (rest_len) {
581 CHECK_VM_STACK_OVERFLOW(ec->cfp, rest_len+1);
582 for (j=0; rest_len > 0; rest_len--, i++, j++) {
583 locals[i] = argv[j];
584 }
585 }
586 args->rest = Qfalse;
587 *ci_flag &= ~VM_CALL_ARGS_SPLAT;
588}
589
590static int
591setup_parameters_complex(rb_execution_context_t * const ec, const rb_iseq_t * const iseq,
592 struct rb_calling_info *const calling,
593 const struct rb_callinfo *ci,
594 VALUE * const locals, const enum arg_setup_type arg_setup_type)
595{
596 const int min_argc = ISEQ_BODY(iseq)->param.lead_num + ISEQ_BODY(iseq)->param.post_num;
597 const int max_argc = (ISEQ_BODY(iseq)->param.flags.has_rest == FALSE) ? min_argc + ISEQ_BODY(iseq)->param.opt_num : UNLIMITED_ARGUMENTS;
598 int given_argc;
599 unsigned int ci_flag = vm_ci_flag(ci);
600 unsigned int kw_flag = ci_flag & (VM_CALL_KWARG | VM_CALL_KW_SPLAT | VM_CALL_KW_SPLAT_MUT);
601 int opt_pc = 0, allow_autosplat = !kw_flag;
602 struct args_info args_body, *args;
603 VALUE keyword_hash = Qnil;
604 VALUE * const orig_sp = ec->cfp->sp;
605 unsigned int i;
606 VALUE flag_keyword_hash = 0;
607 VALUE splat_flagged_keyword_hash = 0;
608 VALUE converted_keyword_hash = 0;
609 VALUE rest_last = 0;
610
611 vm_check_canary(ec, orig_sp);
612 /*
613 * Extend SP for GC.
614 *
615 * [pushed values] [uninitialized values]
616 * <- ci->argc -->
617 * <- ISEQ_BODY(iseq)->param.size------------>
618 * ^ locals ^ sp
619 *
620 * =>
621 * [pushed values] [initialized values ]
622 * <- ci->argc -->
623 * <- ISEQ_BODY(iseq)->param.size------------>
624 * ^ locals ^ sp
625 */
626 for (i=calling->argc; i<ISEQ_BODY(iseq)->param.size; i++) {
627 locals[i] = Qnil;
628 }
629 ec->cfp->sp = &locals[i];
630
631 /* setup args */
632 args = &args_body;
633 given_argc = args->argc = calling->argc;
634 args->argv = locals;
635 args->rest_dupped = ci_flag & VM_CALL_ARGS_SPLAT_MUT;
636
637 if (UNLIKELY(ISEQ_BODY(iseq)->param.flags.anon_rest)) {
638 if ((ci_flag & VM_CALL_ARGS_SPLAT) &&
639 given_argc == ISEQ_BODY(iseq)->param.lead_num + (kw_flag ? 2 : 1) &&
640 !ISEQ_BODY(iseq)->param.flags.has_opt &&
641 !ISEQ_BODY(iseq)->param.flags.has_post &&
642 !ISEQ_BODY(iseq)->param.flags.ruby2_keywords &&
643 (!kw_flag ||
644 !ISEQ_BODY(iseq)->param.flags.has_kw ||
645 !ISEQ_BODY(iseq)->param.flags.has_kwrest ||
646 !ISEQ_BODY(iseq)->param.flags.accepts_no_kwarg)) {
647 args->rest_dupped = true;
648 }
649 }
650
651 if (kw_flag & VM_CALL_KWARG) {
652 args->kw_arg = vm_ci_kwarg(ci);
653
654 if (ISEQ_BODY(iseq)->param.flags.has_kw) {
655 int kw_len = args->kw_arg->keyword_len;
656 /* copy kw_argv */
657 args->kw_argv = ALLOCA_N(VALUE, kw_len);
658 args->argc -= kw_len;
659 given_argc -= kw_len;
660 MEMCPY(args->kw_argv, locals + args->argc, VALUE, kw_len);
661 }
662 else {
663 args->kw_argv = NULL;
664 given_argc = args_kw_argv_to_hash(args);
665 kw_flag |= VM_CALL_KW_SPLAT | VM_CALL_KW_SPLAT_MUT;
666 }
667 }
668 else {
669 args->kw_arg = NULL;
670 args->kw_argv = NULL;
671 }
672
673 if ((ci_flag & VM_CALL_ARGS_SPLAT) && (ci_flag & VM_CALL_KW_SPLAT)) {
674 // f(*a, **kw)
675 args->rest_index = 0;
676 keyword_hash = locals[--args->argc];
677 args->rest = locals[--args->argc];
678
679 if (ignore_keyword_hash_p(keyword_hash, iseq, &kw_flag, &converted_keyword_hash)) {
680 keyword_hash = Qnil;
681 }
682 else if (UNLIKELY(ISEQ_BODY(iseq)->param.flags.ruby2_keywords)) {
683 converted_keyword_hash = check_kwrestarg(converted_keyword_hash, &kw_flag);
684 flag_keyword_hash = converted_keyword_hash;
685 arg_rest_dup(args);
686 rb_ary_push(args->rest, converted_keyword_hash);
687 keyword_hash = Qnil;
688 }
689 else if (!ISEQ_BODY(iseq)->param.flags.has_kwrest && !ISEQ_BODY(iseq)->param.flags.has_kw) {
690 converted_keyword_hash = check_kwrestarg(converted_keyword_hash, &kw_flag);
691 if (ISEQ_BODY(iseq)->param.flags.has_rest) {
692 arg_rest_dup(args);
693 rb_ary_push(args->rest, converted_keyword_hash);
694 keyword_hash = Qnil;
695 }
696 else {
697 // Avoid duping rest when not necessary
698 // Copy rest elements and converted keyword hash directly to VM stack
699 const VALUE *argv = RARRAY_CONST_PTR(args->rest);
700 int j, i=args->argc, rest_len = RARRAY_LENINT(args->rest);
701 if (rest_len) {
702 CHECK_VM_STACK_OVERFLOW(ec->cfp, rest_len+1);
703 given_argc += rest_len;
704 args->argc += rest_len;
705 for (j=0; rest_len > 0; rest_len--, i++, j++) {
706 locals[i] = argv[j];
707 }
708 }
709 locals[i] = converted_keyword_hash;
710 given_argc--;
711 args->argc++;
712 args->rest = Qfalse;
713 ci_flag &= ~(VM_CALL_ARGS_SPLAT|VM_CALL_KW_SPLAT);
714 keyword_hash = Qnil;
715 goto arg_splat_and_kw_splat_flattened;
716 }
717 }
718 else {
719 keyword_hash = converted_keyword_hash;
720 }
721
722 int len = RARRAY_LENINT(args->rest);
723 given_argc += len - 2;
724 }
725 else if (ci_flag & VM_CALL_ARGS_SPLAT) {
726 // f(*a)
727 args->rest_index = 0;
728 args->rest = locals[--args->argc];
729 int len = RARRAY_LENINT(args->rest);
730 given_argc += len - 1;
731
732 if (!kw_flag && len > 0) {
733 rest_last = RARRAY_AREF(args->rest, len - 1);
734 if (RB_TYPE_P(rest_last, T_HASH) && FL_TEST_RAW(rest_last, RHASH_PASS_AS_KEYWORDS)) {
735 // def f(**kw); a = [..., kw]; g(*a)
736 splat_flagged_keyword_hash = rest_last;
737 if (!(RHASH_EMPTY_P(rest_last) || ISEQ_BODY(iseq)->param.flags.has_kw) || (ISEQ_BODY(iseq)->param.flags.has_kwrest)) {
738 rest_last = rb_hash_dup(rest_last);
739 }
740 kw_flag |= VM_CALL_KW_SPLAT | VM_CALL_KW_SPLAT_MUT;
741
742 // Unset rest_dupped set by anon_rest as we may need to modify splat in this case
743 args->rest_dupped = false;
744
745 if (ignore_keyword_hash_p(rest_last, iseq, &kw_flag, &converted_keyword_hash)) {
746 if (ISEQ_BODY(iseq)->param.flags.has_rest) {
747 // Only duplicate/modify splat array if it will be used
748 arg_rest_dup(args);
749 rb_ary_pop(args->rest);
750 }
751 else if (arg_setup_type == arg_setup_block && !ISEQ_BODY(iseq)->param.flags.has_kwrest) {
752 // Avoid hash allocation for empty hashes
753 // Copy rest elements except empty keyword hash directly to VM stack
754 flatten_rest_args(ec, args, locals, &ci_flag);
755 keyword_hash = Qnil;
756 kw_flag = 0;
757 }
758 given_argc--;
759 }
760 else if (!ISEQ_BODY(iseq)->param.flags.has_rest) {
761 // Avoid duping rest when not necessary
762 // Copy rest elements and converted keyword hash directly to VM stack
763 flatten_rest_args(ec, args, locals, &ci_flag);
764
765 if (ISEQ_BODY(iseq)->param.flags.has_kw || ISEQ_BODY(iseq)->param.flags.has_kwrest) {
766 given_argc--;
767 keyword_hash = converted_keyword_hash;
768 }
769 else {
770 locals[args->argc] = converted_keyword_hash;
771 args->argc += 1;
772 keyword_hash = Qnil;
773 kw_flag = 0;
774 }
775 }
776 else {
777 if (rest_last != converted_keyword_hash) {
778 rest_last = converted_keyword_hash;
779 arg_rest_dup(args);
780 RARRAY_ASET(args->rest, len - 1, rest_last);
781 }
782
783 if (ISEQ_BODY(iseq)->param.flags.ruby2_keywords && rest_last) {
784 flag_keyword_hash = rest_last;
785 }
786 else if (ISEQ_BODY(iseq)->param.flags.has_kw || ISEQ_BODY(iseq)->param.flags.has_kwrest) {
787 arg_rest_dup(args);
788 rb_ary_pop(args->rest);
789 given_argc--;
790 keyword_hash = rest_last;
791 }
792 }
793 }
794 }
795 }
796 else {
797 args->rest = Qfalse;
798
799 if (args->argc > 0 && (kw_flag & VM_CALL_KW_SPLAT)) {
800 // f(**kw)
801 VALUE last_arg = args->argv[args->argc-1];
802 if (ignore_keyword_hash_p(last_arg, iseq, &kw_flag, &converted_keyword_hash)) {
803 args->argc--;
804 given_argc--;
805 }
806 else {
807 if (!(kw_flag & VM_CALL_KW_SPLAT_MUT) && !ISEQ_BODY(iseq)->param.flags.has_kw) {
808 converted_keyword_hash = rb_hash_dup(converted_keyword_hash);
809 kw_flag |= VM_CALL_KW_SPLAT_MUT;
810 }
811
812 if (last_arg != converted_keyword_hash) {
813 last_arg = converted_keyword_hash;
814 args->argv[args->argc-1] = last_arg;
815 }
816
817 if (ISEQ_BODY(iseq)->param.flags.ruby2_keywords) {
818 flag_keyword_hash = last_arg;
819 }
820 else if (ISEQ_BODY(iseq)->param.flags.has_kw || ISEQ_BODY(iseq)->param.flags.has_kwrest) {
821 args->argc--;
822 given_argc--;
823 keyword_hash = last_arg;
824 }
825 }
826 }
827 }
828
829 if (flag_keyword_hash) {
830 FL_SET_RAW(flag_keyword_hash, RHASH_PASS_AS_KEYWORDS);
831 }
832
833 arg_splat_and_kw_splat_flattened:
834 if (kw_flag && ISEQ_BODY(iseq)->param.flags.accepts_no_kwarg) {
835 rb_raise(rb_eArgError, "no keywords accepted");
836 }
837
838 switch (arg_setup_type) {
839 case arg_setup_method:
840 break; /* do nothing special */
841 case arg_setup_block:
842 if (given_argc == 1 &&
843 allow_autosplat &&
844 !splat_flagged_keyword_hash &&
845 (min_argc > 0 || ISEQ_BODY(iseq)->param.opt_num > 1) &&
846 !ISEQ_BODY(iseq)->param.flags.ambiguous_param0 &&
847 !((ISEQ_BODY(iseq)->param.flags.has_kw ||
848 ISEQ_BODY(iseq)->param.flags.has_kwrest)
849 && max_argc == 1) &&
850 args_check_block_arg0(args)) {
851 given_argc = RARRAY_LENINT(args->rest);
852 }
853 break;
854 }
855
856 /* argc check */
857 if (given_argc < min_argc) {
858 if (arg_setup_type == arg_setup_block) {
859 CHECK_VM_STACK_OVERFLOW(ec->cfp, min_argc);
860 given_argc = min_argc;
861 args_extend(args, min_argc);
862 }
863 else {
864 argument_arity_error(ec, iseq, given_argc, min_argc, max_argc);
865 }
866 }
867
868 if (given_argc > max_argc && max_argc != UNLIMITED_ARGUMENTS) {
869 if (arg_setup_type == arg_setup_block) {
870 /* truncate */
871 args_reduce(args, given_argc - max_argc);
872 given_argc = max_argc;
873 }
874 else {
875 argument_arity_error(ec, iseq, given_argc, min_argc, max_argc);
876 }
877 }
878
879 if (ISEQ_BODY(iseq)->param.flags.has_lead) {
880 args_setup_lead_parameters(args, ISEQ_BODY(iseq)->param.lead_num, locals + 0);
881 }
882
883 if (ISEQ_BODY(iseq)->param.flags.has_rest || ISEQ_BODY(iseq)->param.flags.has_post){
884 args_copy(args);
885 }
886
887 if (ISEQ_BODY(iseq)->param.flags.has_post) {
888 args_setup_post_parameters(args, ISEQ_BODY(iseq)->param.post_num, locals + ISEQ_BODY(iseq)->param.post_start);
889 }
890
891 if (ISEQ_BODY(iseq)->param.flags.has_opt) {
892 int opt = args_setup_opt_parameters(args, ISEQ_BODY(iseq)->param.opt_num, locals + ISEQ_BODY(iseq)->param.lead_num);
893 opt_pc = (int)ISEQ_BODY(iseq)->param.opt_table[opt];
894 }
895
896 if (ISEQ_BODY(iseq)->param.flags.has_rest) {
897 args_setup_rest_parameter(args, locals + ISEQ_BODY(iseq)->param.rest_start);
898 VALUE ary = *(locals + ISEQ_BODY(iseq)->param.rest_start);
899 VALUE index = RARRAY_LEN(ary) - 1;
900 if (splat_flagged_keyword_hash &&
901 !ISEQ_BODY(iseq)->param.flags.ruby2_keywords &&
902 !ISEQ_BODY(iseq)->param.flags.has_kw &&
903 !ISEQ_BODY(iseq)->param.flags.has_kwrest &&
904 RARRAY_AREF(ary, index) == splat_flagged_keyword_hash) {
905 ((struct RHash *)rest_last)->basic.flags &= ~RHASH_PASS_AS_KEYWORDS;
906 RARRAY_ASET(ary, index, rest_last);
907 }
908 }
909
910 if (ISEQ_BODY(iseq)->param.flags.has_kw) {
911 VALUE * const klocals = locals + ISEQ_BODY(iseq)->param.keyword->bits_start - ISEQ_BODY(iseq)->param.keyword->num;
912
913 if (args->kw_argv != NULL) {
914 const struct rb_callinfo_kwarg *kw_arg = args->kw_arg;
915 args_setup_kw_parameters(ec, iseq, args->kw_argv, kw_arg->keyword_len, kw_arg->keywords, klocals);
916 }
917 else if (!NIL_P(keyword_hash)) {
918 bool remove_hash_value = false;
919 if (ISEQ_BODY(iseq)->param.flags.has_kwrest) {
920 keyword_hash = check_kwrestarg(keyword_hash, &kw_flag);
921 remove_hash_value = true;
922 }
923 args_setup_kw_parameters_from_kwsplat(ec, iseq, keyword_hash, klocals, remove_hash_value);
924 }
925 else {
926#if VM_CHECK_MODE > 0
927 if (args_argc(args) != 0) {
928 VM_ASSERT(ci_flag & VM_CALL_ARGS_SPLAT);
929 VM_ASSERT(!(ci_flag & (VM_CALL_KWARG | VM_CALL_KW_SPLAT | VM_CALL_KW_SPLAT_MUT)));
930 VM_ASSERT(!kw_flag);
931 VM_ASSERT(!ISEQ_BODY(iseq)->param.flags.has_rest);
932 VM_ASSERT(RARRAY_LENINT(args->rest) > 0);
933 VM_ASSERT(RB_TYPE_P(rest_last, T_HASH));
934 VM_ASSERT(FL_TEST_RAW(rest_last, RHASH_PASS_AS_KEYWORDS));
935 VM_ASSERT(args_argc(args) == 1);
936 }
937#endif
938 args_setup_kw_parameters(ec, iseq, NULL, 0, NULL, klocals);
939 }
940 }
941 else if (ISEQ_BODY(iseq)->param.flags.has_kwrest) {
942 args_setup_kw_rest_parameter(keyword_hash, locals + ISEQ_BODY(iseq)->param.keyword->rest_start,
943 kw_flag, ISEQ_BODY(iseq)->param.flags.anon_kwrest);
944 }
945 else if (!NIL_P(keyword_hash) && RHASH_SIZE(keyword_hash) > 0 && arg_setup_type == arg_setup_method) {
946 argument_kw_error(ec, iseq, "unknown", rb_hash_keys(keyword_hash));
947 }
948
949 if (ISEQ_BODY(iseq)->param.flags.has_block) {
950 if (ISEQ_BODY(iseq)->local_iseq == iseq) {
951 /* Do nothing */
952 }
953 else {
954 args_setup_block_parameter(ec, calling, locals + ISEQ_BODY(iseq)->param.block_start);
955 }
956 }
957
958#if 0
959 {
960 int i;
961 for (i=0; i<ISEQ_BODY(iseq)->param.size; i++) {
962 ruby_debug_printf("local[%d] = %p\n", i, (void *)locals[i]);
963 }
964 }
965#endif
966
967 ec->cfp->sp = orig_sp;
968 return opt_pc;
969}
970
971static void
972raise_argument_error(rb_execution_context_t *ec, const rb_iseq_t *iseq, const VALUE exc)
973{
974 VALUE at;
975
976 if (iseq) {
977 vm_push_frame(ec, iseq, VM_FRAME_MAGIC_DUMMY | VM_ENV_FLAG_LOCAL, Qnil /* self */,
978 VM_BLOCK_HANDLER_NONE /* specval*/, Qfalse /* me or cref */,
979 ISEQ_BODY(iseq)->iseq_encoded,
980 ec->cfp->sp, 0, 0 /* stack_max */);
981 at = rb_ec_backtrace_object(ec);
982 rb_backtrace_use_iseq_first_lineno_for_last_location(at);
983 rb_vm_pop_frame(ec);
984 }
985 else {
986 at = rb_ec_backtrace_object(ec);
987 }
988
989 rb_ivar_set(exc, idBt_locations, at);
990 rb_exc_set_backtrace(exc, at);
991 rb_exc_raise(exc);
992}
993
994static void
995argument_arity_error(rb_execution_context_t *ec, const rb_iseq_t *iseq, const int miss_argc, const int min_argc, const int max_argc)
996{
997 VALUE exc = rb_arity_error_new(miss_argc, min_argc, max_argc);
998 if (ISEQ_BODY(iseq)->param.flags.has_kw) {
999 const struct rb_iseq_param_keyword *const kw = ISEQ_BODY(iseq)->param.keyword;
1000 const ID *keywords = kw->table;
1001 int req_key_num = kw->required_num;
1002 if (req_key_num > 0) {
1003 static const char required[] = "; required keywords";
1004 VALUE mesg = rb_attr_get(exc, idMesg);
1005 rb_str_resize(mesg, RSTRING_LEN(mesg)-1);
1006 rb_str_cat(mesg, required, sizeof(required) - 1 - (req_key_num == 1));
1007 rb_str_cat_cstr(mesg, ":");
1008 do {
1009 rb_str_cat_cstr(mesg, " ");
1010 rb_str_append(mesg, rb_id2str(*keywords++));
1011 rb_str_cat_cstr(mesg, ",");
1012 } while (--req_key_num);
1013 RSTRING_PTR(mesg)[RSTRING_LEN(mesg)-1] = ')';
1014 }
1015 }
1016 raise_argument_error(ec, iseq, exc);
1017}
1018
1019static void
1020argument_kw_error(rb_execution_context_t *ec, const rb_iseq_t *iseq, const char *error, const VALUE keys)
1021{
1022 raise_argument_error(ec, iseq, rb_keyword_error_new(error, keys));
1023}
1024
1025static VALUE
1026vm_to_proc(VALUE proc)
1027{
1028 if (UNLIKELY(!rb_obj_is_proc(proc))) {
1029 VALUE b;
1030 const rb_callable_method_entry_t *me =
1031 rb_callable_method_entry_with_refinements(CLASS_OF(proc), idTo_proc, NULL);
1032
1033 if (me) {
1034 b = rb_vm_call0(GET_EC(), proc, idTo_proc, 0, NULL, me, RB_NO_KEYWORDS);
1035 }
1036 else {
1037 /* NOTE: calling method_missing */
1038 b = rb_check_convert_type_with_id(proc, T_DATA, "Proc", idTo_proc);
1039 }
1040
1041 if (NIL_P(b) || !rb_obj_is_proc(b)) {
1042 rb_raise(rb_eTypeError,
1043 "wrong argument type %s (expected Proc)",
1044 rb_obj_classname(proc));
1045 }
1046 return b;
1047 }
1048 else {
1049 return proc;
1050 }
1051}
1052
1053static VALUE
1054refine_sym_proc_call(RB_BLOCK_CALL_FUNC_ARGLIST(yielded_arg, callback_arg))
1055{
1056 VALUE obj;
1057 ID mid;
1058 const rb_callable_method_entry_t *me = 0; /* for hidden object case */
1059 rb_execution_context_t *ec;
1060 const VALUE symbol = RARRAY_AREF(callback_arg, 0);
1061 const VALUE refinements = RARRAY_AREF(callback_arg, 1);
1062 int kw_splat = RB_PASS_CALLED_KEYWORDS;
1063 VALUE klass;
1064
1065 if (argc-- < 1) {
1066 rb_raise(rb_eArgError, "no receiver given");
1067 }
1068 obj = *argv++;
1069
1070 mid = SYM2ID(symbol);
1071 for (klass = CLASS_OF(obj); klass; klass = RCLASS_SUPER(klass)) {
1072 me = rb_callable_method_entry(klass, mid);
1073 if (me) {
1074 me = rb_resolve_refined_method_callable(refinements, me);
1075 if (me) break;
1076 }
1077 }
1078
1079 ec = GET_EC();
1080 if (!NIL_P(blockarg)) {
1081 vm_passed_block_handler_set(ec, blockarg);
1082 }
1083 if (!me) {
1084 return method_missing(ec, obj, mid, argc, argv, MISSING_NOENTRY, kw_splat);
1085 }
1086 return rb_vm_call0(ec, obj, mid, argc, argv, me, kw_splat);
1087}
1088
1089static VALUE
1090vm_caller_setup_arg_block(const rb_execution_context_t *ec, rb_control_frame_t *reg_cfp,
1091 const struct rb_callinfo *ci, const rb_iseq_t *blockiseq, const int is_super)
1092{
1093 if (vm_ci_flag(ci) & VM_CALL_ARGS_BLOCKARG) {
1094 VALUE block_code = *(--reg_cfp->sp);
1095
1096 if (NIL_P(block_code)) {
1097 return VM_BLOCK_HANDLER_NONE;
1098 }
1099 else if (block_code == rb_block_param_proxy) {
1100 return VM_CF_BLOCK_HANDLER(reg_cfp);
1101 }
1102 else if (SYMBOL_P(block_code) && rb_method_basic_definition_p(rb_cSymbol, idTo_proc)) {
1103 const rb_cref_t *cref = vm_env_cref(reg_cfp->ep);
1104 if (cref && !NIL_P(cref->refinements)) {
1105 VALUE ref = cref->refinements;
1106 VALUE func = rb_hash_lookup(ref, block_code);
1107 if (NIL_P(func)) {
1108 /* TODO: limit cached funcs */
1109 VALUE callback_arg = rb_ary_hidden_new(2);
1110 rb_ary_push(callback_arg, block_code);
1111 rb_ary_push(callback_arg, ref);
1112 OBJ_FREEZE(callback_arg);
1113 func = rb_func_lambda_new(refine_sym_proc_call, callback_arg, 1, UNLIMITED_ARGUMENTS);
1114 rb_hash_aset(ref, block_code, func);
1115 }
1116 block_code = func;
1117 }
1118 return block_code;
1119 }
1120 else {
1121 return vm_to_proc(block_code);
1122 }
1123 }
1124 else if (blockiseq != NULL) { /* likely */
1125 struct rb_captured_block *captured = VM_CFP_TO_CAPTURED_BLOCK(reg_cfp);
1126 captured->code.iseq = blockiseq;
1127 return VM_BH_FROM_ISEQ_BLOCK(captured);
1128 }
1129 else {
1130 if (is_super) {
1131 return GET_BLOCK_HANDLER();
1132 }
1133 else {
1134 return VM_BLOCK_HANDLER_NONE;
1135 }
1136 }
1137}
1138
1139static void vm_adjust_stack_forwarding(const struct rb_execution_context_struct *ec, struct rb_control_frame_struct *cfp, int argc, VALUE splat);
1140
1141static VALUE
1142vm_caller_setup_fwd_args(const rb_execution_context_t *ec, rb_control_frame_t *reg_cfp,
1143 CALL_DATA cd, const rb_iseq_t *blockiseq, const int is_super,
1144 struct rb_forwarding_call_data *adjusted_cd, struct rb_callinfo *adjusted_ci)
1145{
1146 CALL_INFO site_ci = cd->ci;
1147 VALUE bh = Qundef;
1148
1149 RUBY_ASSERT(ISEQ_BODY(ISEQ_BODY(GET_ISEQ())->local_iseq)->param.flags.forwardable);
1150 CALL_INFO caller_ci = (CALL_INFO)TOPN(0);
1151
1152 unsigned int site_argc = vm_ci_argc(site_ci);
1153 unsigned int site_flag = vm_ci_flag(site_ci);
1154 ID site_mid = vm_ci_mid(site_ci);
1155
1156 unsigned int caller_argc = vm_ci_argc(caller_ci);
1157 unsigned int caller_flag = vm_ci_flag(caller_ci);
1158 const struct rb_callinfo_kwarg * kw = vm_ci_kwarg(caller_ci);
1159
1160 VALUE splat = Qfalse;
1161
1162 if (site_flag & VM_CALL_ARGS_SPLAT) {
1163 // If we're called with args_splat, the top 1 should be an array
1164 splat = TOPN(1);
1165 site_argc += (RARRAY_LEN(splat) - 1);
1166 }
1167
1168 // Need to setup the block in case of e.g. `super { :block }`
1169 if (is_super && blockiseq) {
1170 bh = vm_caller_setup_arg_block(ec, GET_CFP(), site_ci, blockiseq, is_super);
1171 }
1172 else {
1173 bh = VM_ENV_BLOCK_HANDLER(GET_LEP());
1174 }
1175
1176 vm_adjust_stack_forwarding(ec, GET_CFP(), caller_argc, splat);
1177
1178 *adjusted_ci = VM_CI_ON_STACK(
1179 site_mid,
1180 ((caller_flag & ~(VM_CALL_ARGS_SIMPLE | VM_CALL_FCALL)) |
1181 (site_flag & (VM_CALL_FCALL | VM_CALL_FORWARDING))),
1182 site_argc + caller_argc,
1183 kw
1184 );
1185
1186 adjusted_cd->cd.ci = adjusted_ci;
1187 adjusted_cd->cd.cc = cd->cc;
1188 adjusted_cd->caller_ci = caller_ci;
1189
1190 return bh;
1191}
RUBY_ASSERT
#define RUBY_ASSERT(...)
Asserts that the given expression is truthy if and only if RUBY_DEBUG is truthy.
Definition assert.h:219
Qundef
#define Qundef
Old name of RUBY_Qundef.
Definition special_consts.h:62
INT2FIX
#define INT2FIX
Old name of RB_INT2FIX.
Definition long.h:48
ID2SYM
#define ID2SYM
Old name of RB_ID2SYM.
Definition symbol.h:44
OBJ_FREEZE
#define OBJ_FREEZE
Old name of RB_OBJ_FREEZE.
Definition fl_type.h:135
SYM2ID
#define SYM2ID
Old name of RB_SYM2ID.
Definition symbol.h:45
T_DATA
#define T_DATA
Old name of RUBY_T_DATA.
Definition value_type.h:60
CLASS_OF
#define CLASS_OF
Old name of rb_class_of.
Definition globals.h:203
T_HASH
#define T_HASH
Old name of RUBY_T_HASH.
Definition value_type.h:65
FL_TEST_RAW
#define FL_TEST_RAW
Old name of RB_FL_TEST_RAW.
Definition fl_type.h:132
Qtrue
#define Qtrue
Old name of RUBY_Qtrue.
Definition special_consts.h:61
Qnil
#define Qnil
Old name of RUBY_Qnil.
Definition special_consts.h:60
Qfalse
#define Qfalse
Old name of RUBY_Qfalse.
Definition special_consts.h:59
NIL_P
#define NIL_P
Old name of RB_NIL_P.
Definition special_consts.h:55
FL_SET_RAW
#define FL_SET_RAW
Old name of RB_FL_SET_RAW.
Definition fl_type.h:130
SYMBOL_P
#define SYMBOL_P
Old name of RB_SYMBOL_P.
Definition value_type.h:88
rb_eTypeError
VALUE rb_eTypeError
TypeError exception.
Definition error.c:1430
rb_cSymbol
VALUE rb_cSymbol
Symbol class.
Definition string.c:79
UNLIMITED_ARGUMENTS
#define UNLIMITED_ARGUMENTS
This macro is used in conjunction with rb_check_arity().
Definition error.h:35
rb_obj_is_proc
VALUE rb_obj_is_proc(VALUE recv)
Queries if the given object is a proc.
Definition proc.c:119
rb_str_append
VALUE rb_str_append(VALUE dst, VALUE src)
Identical to rb_str_buf_append(), except it converts the right hand side before concatenating.
Definition string.c:3680
rb_str_cat
VALUE rb_str_cat(VALUE dst, const char *src, long srclen)
Destructively appends the passed contents to the string.
Definition string.c:3448
rb_str_cat_cstr
#define rb_str_cat_cstr(buf, str)
Identical to rb_str_cat(), except it assumes the passed pointer is a pointer to a C string.
Definition string.h:1656
rb_ivar_set
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.
Definition variable.c:1951
len
int len
Length of the buffer.
Definition io.h:8
RB_BLOCK_CALL_FUNC_ARGLIST
#define RB_BLOCK_CALL_FUNC_ARGLIST(yielded_arg, callback_arg)
Shim for block function parameters.
Definition iterator.h:58
MEMCPY
#define MEMCPY(p1, p2, type, n)
Handy macro to call memcpy.
Definition memory.h:372
ALLOCA_N
#define ALLOCA_N(type, n)
Definition memory.h:292
RARRAY_LEN
#define RARRAY_LEN
Just another name of rb_array_len.
Definition rarray.h:51
RARRAY_LENINT
static int RARRAY_LENINT(VALUE ary)
Identical to rb_array_len(), except it differs for the return type.
Definition rarray.h:281
RARRAY_ASET
static void RARRAY_ASET(VALUE ary, long i, VALUE v)
Assigns an object in an array.
Definition rarray.h:386
RARRAY_AREF
#define RARRAY_AREF(a, i)
Definition rarray.h:403
RARRAY_CONST_PTR
#define RARRAY_CONST_PTR
Just another name of rb_array_const_ptr.
Definition rarray.h:52
RCLASS_SUPER
#define RCLASS_SUPER
Just another name of rb_class_get_superclass.
Definition rclass.h:44
RHASH_SIZE
#define RHASH_SIZE(h)
Queries the size of the hash.
Definition rhash.h:69
RHASH_EMPTY_P
#define RHASH_EMPTY_P(h)
Checks if the hash is empty.
Definition rhash.h:79
rb_obj_classname
const char * rb_obj_classname(VALUE obj)
Queries the name of the class of the passed object.
Definition variable.c:507
RB_PASS_CALLED_KEYWORDS
#define RB_PASS_CALLED_KEYWORDS
Pass keywords if current method is called with keywords, useful for argument delegation.
Definition scan_args.h:78
RB_NO_KEYWORDS
#define RB_NO_KEYWORDS
Do not pass keywords.
Definition scan_args.h:69
RHash
Definition hash.h:53
args_info
Definition vm_args.c:19
rb_callinfo_kwarg
Definition vm_callinfo.h:48
rb_callinfo
Definition vm_callinfo.h:65
rb_calling_info
Definition vm_core.h:306
rb_captured_block
Definition vm_core.h:867
rb_control_frame_struct
Definition vm_core.h:900
rb_execution_context_struct
Definition vm_core.h:1022
rb_forwarding_call_data
Definition vm_insnhelper.h:69
ID
uintptr_t ID
Type that represents a Ruby identifier such as a variable name.
Definition value.h:52
VALUE
uintptr_t VALUE
Type that represents a Ruby object.
Definition value.h:40
RB_TYPE_P
static bool RB_TYPE_P(VALUE obj, enum ruby_value_type t)
Queries if the given object is of given type.
Definition value_type.h:376