12#include "ruby/internal/config.h"
23#include "internal/array.h"
24#include "internal/compar.h"
25#include "internal/enum.h"
26#include "internal/enumerator.h"
27#include "internal/error.h"
28#include "internal/numeric.h"
29#include "internal/range.h"
32static ID id_beg, id_end, id_excl;
41#define RANGE_SET_BEG(r, v) (RSTRUCT_SET(r, 0, v))
42#define RANGE_SET_END(r, v) (RSTRUCT_SET(r, 1, v))
43#define RANGE_SET_EXCL(r, v) (RSTRUCT_SET(r, 2, v))
45#define EXCL(r) RTEST(RANGE_EXCL(r))
55 rb_raise(rb_eArgError,
"bad value for range");
58 RANGE_SET_EXCL(range, exclude_end);
59 RANGE_SET_BEG(range, beg);
60 RANGE_SET_END(range, end);
72 range_init(range, beg, end, RBOOL(exclude_end));
77range_modify(
VALUE range)
79 rb_check_frozen(range);
81 if (RANGE_EXCL(range) !=
Qnil) {
82 rb_name_err_raise(
"'initialize' called twice", range,
ID2SYM(idInitialize));
102range_initialize(
int argc,
VALUE *argv,
VALUE range)
104 VALUE beg, end, flags;
108 range_init(range, beg, end, RBOOL(
RTEST(flags)));
117 rb_struct_init_copy(range, orig);
134range_exclude_end_p(
VALUE range)
136 return RBOOL(EXCL(range));
140recursive_equal(
VALUE range,
VALUE obj,
int recur)
142 if (recur)
return Qtrue;
143 if (!
rb_equal(RANGE_BEG(range), RANGE_BEG(obj)))
145 if (!
rb_equal(RANGE_END(range), RANGE_END(obj)))
148 return RBOOL(EXCL(range) == EXCL(obj));
206 return rb_cmpint(r, a, b);
210recursive_eql(
VALUE range,
VALUE obj,
int recur)
212 if (recur)
return Qtrue;
213 if (!
rb_eql(RANGE_BEG(range), RANGE_BEG(obj)))
215 if (!
rb_eql(RANGE_END(range), RANGE_END(obj)))
218 return RBOOL(EXCL(range) == EXCL(obj));
273range_hash(
VALUE range)
275 st_index_t hash = EXCL(range);
279 v = rb_hash(RANGE_BEG(range));
281 v = rb_hash(RANGE_END(range));
293 VALUE b = RANGE_BEG(range);
294 VALUE e = RANGE_END(range);
298 while (r_less(v, e) < 0) {
299 if ((*func)(v, arg))
break;
300 v = rb_funcallv(v, id_succ, 0, 0);
304 while ((c = r_less(v, e)) <= 0) {
305 if ((*func)(v, arg))
break;
307 v = rb_funcallv(v, id_succ, 0, 0);
316step_i_iter(
VALUE arg)
321 iter[0] -=
INT2FIX(1) & ~FIXNUM_FLAG;
326 if (iter[0] !=
INT2FIX(0))
return false;
334 if (step_i_iter(arg)) {
343 if (step_i_iter(arg)) {
350discrete_object_p(
VALUE obj)
356linear_object_p(
VALUE obj)
373check_step_domain(
VALUE step)
380 cmp = rb_cmpint(rb_funcallv(step, idCmp, 1, &zero), step, zero);
382 rb_raise(rb_eArgError,
"step can't be negative");
385 rb_raise(rb_eArgError,
"step can't be 0");
393 VALUE b = RANGE_BEG(range), e = RANGE_END(range);
400 return ruby_num_interval_step_size(b, e, step, EXCL(range));
489 b = RANGE_BEG(range);
490 e = RANGE_END(range);
504 if (b_num_p || !
NIL_P(str_b) || !
NIL_P(sym_b) || (
NIL_P(b) && e_num_p))
507 rb_raise(rb_eArgError,
"step is required for non-numeric ranges");
513 rb_raise(rb_eArgError,
"step can't be 0");
520 if (step_num_p && ((b_num_p && (
NIL_P(e) || e_num_p)) || (
NIL_P(b) && e_num_p))) {
521 return rb_arith_seq_new(range,
ID2SYM(rb_frame_this_func()), argc, argv,
522 range_step_size, b, e, step, EXCL(range));
527 rb_raise(rb_eArgError,
"#step for non-numeric beginless ranges is meaningless");
534 rb_raise(rb_eArgError,
"#step iteration for beginless ranges is meaningless");
547 for (;; b = rb_big_plus(b, step))
574 else if (b_num_p && step_num_p && ruby_float_step(b, e, step, EXCL(range), TRUE)) {
584 rb_str_upto_endless_each(str_b, step_i, (
VALUE)iter);
587 rb_str_upto_each(str_b, e, EXCL(range), step_i, (
VALUE)iter);
596 rb_str_upto_endless_each(sym_b, sym_step_i, (
VALUE)iter);
599 rb_str_upto_each(sym_b,
rb_sym2str(e), EXCL(range), sym_step_i, (
VALUE)iter);
607 else if (b_num_p && step_num_p && r_less(step,
INT2FIX(0)) < 0) {
610 for (; r_less(e, v) < 0; v =
rb_funcall(v, id_plus, 1, step))
614 for (; (c = r_less(e, v)) <= 0; v =
rb_funcall(v, id_plus, 1, step)) {
621 else if ((dir = r_less(b, e)) == 0) {
626 else if (dir == r_less(b,
rb_funcall(b, id_plus, 1, step))) {
634 for (; r_less(v, e) == dir; v =
rb_funcall(v, id_plus, 1, step))
638 for (; (c = r_less(v, e)) == dir || c == 0; v =
rb_funcall(v, id_plus, 1, step)) {
672 return range_step(1, &step, range);
675#if SIZEOF_DOUBLE == 8 && defined(HAVE_INT64_T)
682int64_as_double_to_num(int64_t i)
684 union int64_double convert;
696double_as_int64(
double d)
698 union int64_double convert;
700 return d < 0 ? -convert.i : convert.i;
715 return RTEST(is_int) && !UNDEF_P(is_int);
719bsearch_integer_range(
VALUE beg,
VALUE end,
int excl)
724#define BSEARCH_CHECK(expr) \
726 VALUE val = (expr); \
727 VALUE v = rb_yield(val); \
729 if (v == INT2FIX(0)) return val; \
730 smaller = (SIGNED_VALUE)v < 0; \
732 else if (v == Qtrue) { \
736 else if (!RTEST(v)) { \
739 else if (rb_obj_is_kind_of(v, rb_cNumeric)) { \
740 int cmp = rb_cmpint(rb_funcall(v, id_cmp, 1, INT2FIX(0)), v, INT2FIX(0)); \
741 if (!cmp) return val; \
745 rb_raise(rb_eTypeError, "wrong argument type %"PRIsVALUE \
746 " (must be numeric, true, false or nil)", \
768 rb_cmpint(
rb_funcall(low, id_cmp, 1, mid), low, mid) < 0) {
791range_bsearch(
VALUE range)
816#define BSEARCH(conv, excl) \
818 RETURN_ENUMERATOR(range, 0, 0); \
819 if (!(excl)) high++; \
821 while (low + 1 < high) { \
822 mid = ((high < 0) == (low < 0)) ? low + ((high - low) / 2) \
823 : (low + high) / 2; \
824 BSEARCH_CHECK(conv(mid)); \
835#define BSEARCH_FIXNUM(beg, end, excl) \
837 long low = FIX2LONG(beg); \
838 long high = FIX2LONG(end); \
840 BSEARCH(INT2FIX, (excl)); \
843 beg = RANGE_BEG(range);
844 end = RANGE_END(range);
847 BSEARCH_FIXNUM(beg, end, EXCL(range));
849#if SIZEOF_DOUBLE == 8 && defined(HAVE_INT64_T)
854 BSEARCH(int64_as_double_to_num, EXCL(range));
857 else if (is_integer_p(beg) && is_integer_p(end)) {
859 return bsearch_integer_range(beg, end, EXCL(range));
861 else if (is_integer_p(beg) &&
NIL_P(end)) {
869 BSEARCH_FIXNUM(beg, mid,
false);
872 return bsearch_integer_range(beg, mid,
false);
879 else if (
NIL_P(beg) && is_integer_p(end)) {
887 BSEARCH_FIXNUM(mid, end,
false);
890 return bsearch_integer_range(mid, end,
false);
916#define CANT_ITERATE_FROM(x) \
917 rb_raise(rb_eTypeError, "can't iterate from %s", \
942range_size(
VALUE range)
944 VALUE b = RANGE_BEG(range), e = RANGE_END(range);
948 return ruby_num_interval_step_size(b, e,
INT2FIX(1), EXCL(range));
955 if (!discrete_object_p(b)) {
956 CANT_ITERATE_FROM(b);
963range_reverse_size(
VALUE range)
965 VALUE b = RANGE_BEG(range), e = RANGE_END(range);
968 CANT_ITERATE_FROM(e);
973 return ruby_num_interval_step_size(b, e,
INT2FIX(1), EXCL(range));
976 CANT_ITERATE_FROM(e);
985 CANT_ITERATE_FROM(e);
989 if (!discrete_object_p(b)) {
990 CANT_ITERATE_FROM(e);
996#undef CANT_ITERATE_FROM
1012range_to_a(
VALUE range)
1014 if (
NIL_P(RANGE_END(range))) {
1015 rb_raise(
rb_eRangeError,
"cannot convert endless range to an array");
1023 return range_size(range);
1029 return range_reverse_size(range);
1034range_each_bignum_endless(
VALUE beg)
1036 for (;; beg = rb_big_plus(beg,
INT2FIX(1))) {
1044range_each_fixnum_endless(
VALUE beg)
1057 long lim =
FIX2LONG(end) + !EXCL(range);
1058 for (
long i =
FIX2LONG(beg); i < lim; i++) {
1082range_each(
VALUE range)
1089 beg = RANGE_BEG(range);
1090 end = RANGE_END(range);
1093 range_each_fixnum_endless(beg);
1096 return range_each_fixnum_loop(beg, end, range);
1105 if (
NIL_P(end)) range_each_fixnum_endless(beg);
1106 if (
FIXNUM_P(end))
return range_each_fixnum_loop(beg, end, range);
1109 if (
NIL_P(end)) range_each_bignum_endless(beg);
1125 while (rb_big_cmp(beg, end) ==
INT2FIX(-1)) {
1127 beg = rb_big_plus(beg,
INT2FIX(1));
1132 while ((c = rb_big_cmp(beg, end)) !=
INT2FIX(1)) {
1135 beg = rb_big_plus(beg,
INT2FIX(1));
1143 rb_str_upto_endless_each(beg, sym_each_i, 0);
1146 rb_str_upto_each(beg,
rb_sym2str(end), EXCL(range), sym_each_i, 0);
1154 rb_str_upto_each(tmp, end, EXCL(range), each_i, 0);
1157 rb_str_upto_endless_each(tmp, each_i, 0);
1161 if (!discrete_object_p(beg)) {
1166 range_each_func(range, each_i, 0);
1168 for (;; beg = rb_funcallv(beg, id_succ, 0, 0))
1177range_reverse_each_bignum_beginless(
VALUE end)
1181 for (;; end = rb_big_minus(end,
INT2FIX(1))) {
1188range_reverse_each_bignum(
VALUE beg,
VALUE end)
1193 while ((c = rb_big_cmp(beg, end)) !=
INT2FIX(1)) {
1196 end = rb_big_minus(end,
INT2FIX(1));
1201range_reverse_each_positive_bignum_section(
VALUE beg,
VALUE end)
1211 range_reverse_each_bignum(beg, end);
1215range_reverse_each_fixnum_section(
VALUE beg,
VALUE end)
1233 for (
long i = e; i >= b; --i) {
1239range_reverse_each_negative_bignum_section(
VALUE beg,
VALUE end)
1248 range_reverse_each_bignum_beginless(end);
1253 range_reverse_each_bignum(beg, end);
1276range_reverse_each(
VALUE range)
1280 VALUE beg = RANGE_BEG(range);
1281 VALUE end = RANGE_END(range);
1282 int excl = EXCL(range);
1293 end = rb_int_minus(end,
INT2FIX(1));
1296 range_reverse_each_fixnum_section(beg, end);
1300 end = rb_int_minus(end,
INT2FIX(1));
1302 range_reverse_each_positive_bignum_section(beg, end);
1303 range_reverse_each_fixnum_section(beg, end);
1304 range_reverse_each_negative_bignum_section(beg, end);
1326range_begin(
VALUE range)
1328 return RANGE_BEG(range);
1347range_end(
VALUE range)
1349 return RANGE_END(range);
1362 rb_ary_push(ary[1], i);
1391range_first(
int argc,
VALUE *argv,
VALUE range)
1395 if (
NIL_P(RANGE_BEG(range))) {
1396 rb_raise(
rb_eRangeError,
"cannot get the first element of beginless range");
1398 if (argc == 0)
return RANGE_BEG(range);
1409rb_int_range_last(
int argc,
VALUE *argv,
VALUE range)
1419 b = RANGE_BEG(range);
1420 e = RANGE_END(range);
1425 len_1 = rb_int_minus(e, b);
1427 e = rb_int_minus(e, ONE);
1431 len = rb_int_plus(len_1, ONE);
1434 if (FIXNUM_ZERO_P(
len) || rb_num_negative_p(
len)) {
1435 return rb_ary_new_capa(0);
1441 rb_raise(rb_eArgError,
"negative array size");
1450 ary = rb_ary_new_capa(n);
1451 b = rb_int_minus(e, nv);
1453 b = rb_int_plus(b, ONE);
1454 rb_ary_push(ary, b);
1497range_last(
int argc,
VALUE *argv,
VALUE range)
1501 if (
NIL_P(RANGE_END(range))) {
1502 rb_raise(
rb_eRangeError,
"cannot get the last element of endless range");
1504 if (argc == 0)
return RANGE_END(range);
1506 b = RANGE_BEG(range);
1507 e = RANGE_END(range);
1509 RB_LIKELY(rb_method_basic_definition_p(
rb_cRange, idEach))) {
1510 return rb_int_range_last(argc, argv, range);
1512 return rb_ary_last(argc, argv,
rb_Array(range));
1600 if (
NIL_P(RANGE_BEG(range))) {
1601 rb_raise(
rb_eRangeError,
"cannot get the minimum of beginless range");
1605 if (
NIL_P(RANGE_END(range))) {
1606 rb_raise(
rb_eRangeError,
"cannot get the minimum of endless range with custom comparison method");
1610 else if (argc != 0) {
1611 return range_first(argc, argv, range);
1614 VALUE b = RANGE_BEG(range);
1615 VALUE e = RANGE_END(range);
1616 int c =
NIL_P(e) ? -1 : OPTIMIZED_CMP(b, e);
1618 if (c > 0 || (c == 0 && EXCL(range)))
1708 VALUE e = RANGE_END(range);
1711 if (
NIL_P(RANGE_END(range))) {
1712 rb_raise(
rb_eRangeError,
"cannot get the maximum of endless range");
1715 VALUE b = RANGE_BEG(range);
1719 rb_raise(
rb_eRangeError,
"cannot get the maximum of beginless range with custom comparison method");
1724 int c =
NIL_P(b) ? -1 : OPTIMIZED_CMP(b, e);
1730 rb_raise(
rb_eTypeError,
"cannot exclude non Integer end value");
1732 if (c == 0)
return Qnil;
1734 rb_raise(
rb_eTypeError,
"cannot exclude end value with non Integer begin value");
1792range_minmax(
VALUE range)
1797 return rb_assoc_new(
1810 b = RANGE_BEG(range);
1811 e = RANGE_END(range);
1820 if (UNDEF_P(b))
return (
int)
Qfalse;
1822 if (UNDEF_P(e))
return (
int)
Qfalse;
1824 if (UNDEF_P(x))
return (
int)
Qfalse;
1856rb_range_component_beg_len(
VALUE b,
VALUE e,
int excl,
1857 long *begp,
long *lenp,
long len,
int err)
1863 if (
NIL_P(e)) excl = 0;
1873 if (err == 0 || err == 2) {
1900 VALUE res = rb_range_component_beg_len(b, e, excl, begp, lenp,
len, err);
1901 if (
NIL_P(res) && err) {
1930range_to_s(
VALUE range)
1944inspect_range(
VALUE range,
VALUE dummy,
int recur)
1949 return rb_str_new2(EXCL(range) ?
"(... ... ...)" :
"(... .. ...)");
1951 if (!
NIL_P(RANGE_BEG(range)) ||
NIL_P(RANGE_END(range))) {
1958 if (
NIL_P(RANGE_BEG(range)) || !
NIL_P(RANGE_END(range))) {
1989range_inspect(
VALUE range)
2039 return r_cover_p(range, RANGE_BEG(range), RANGE_END(range), val);
2075 VALUE ret = range_include_internal(range, val);
2076 if (!UNDEF_P(ret))
return ret;
2097 if (linear_object_p(val))
return Qtrue;
2101 rb_raise(
rb_eTypeError,
"cannot determine inclusion in beginless/endless ranges");
2108range_include_internal(
VALUE range,
VALUE val)
2110 VALUE beg = RANGE_BEG(range);
2111 VALUE end = RANGE_END(range);
2113 linear_object_p(beg) || linear_object_p(end);
2115 if (nv || range_integer_edge_p(beg, end)) {
2116 return r_cover_p(range, beg, end, val);
2118 else if (range_string_range_p(beg, end)) {
2119 return rb_str_include_range_p(beg, end, val, RANGE_EXCL(range));
2122 return range_include_fallback(beg, end, val);
2259 beg = RANGE_BEG(range);
2260 end = RANGE_END(range);
2263 return RBOOL(r_cover_range_p(range, beg, end, val));
2265 return r_cover_p(range, beg, end, val);
2271 return rb_funcallv(r, rb_intern(
"max"), 0, 0);
2277 VALUE val_beg, val_end, val_max;
2280 val_beg = RANGE_BEG(val);
2281 val_end = RANGE_END(val);
2283 if (!
NIL_P(end) &&
NIL_P(val_end))
return FALSE;
2284 if (!
NIL_P(beg) &&
NIL_P(val_beg))
return FALSE;
2285 if (!
NIL_P(val_beg) && !
NIL_P(val_end) && r_less(val_beg, val_end) > (EXCL(val) ? -1 : 0)) return FALSE;
2286 if (!
NIL_P(val_beg) && !r_cover_p(range, beg, end, val_beg))
return FALSE;
2291 if (
NIL_P(r_cmp_end))
return FALSE;
2292 cmp_end = rb_cmpint(r_cmp_end, end, val_end);
2295 cmp_end = r_less(end, val_end);
2299 if (EXCL(range) == EXCL(val)) {
2300 return cmp_end >= 0;
2302 else if (EXCL(range)) {
2305 else if (cmp_end >= 0) {
2310 if (
NIL_P(val_max))
return FALSE;
2312 return r_less(end, val_max) >= 0;
2318 if (
NIL_P(beg) || r_less(beg, val) <= 0) {
2319 int excl = EXCL(range);
2320 if (
NIL_P(end) || r_less(val, end) <= -excl)
2327range_dumper(
VALUE range)
2340 VALUE beg, end, excl;
2346 range_modify(range);
2351 range_init(range, beg, end, RBOOL(
RTEST(excl)));
2357range_alloc(
VALUE klass)
2396range_count(
int argc,
VALUE *argv,
VALUE range)
2409 VALUE beg = RANGE_BEG(range), end = RANGE_END(range);
2416 if (is_integer_p(beg)) {
2417 VALUE size = range_size(range);
2427empty_region_p(
VALUE beg,
VALUE end,
int excl)
2429 if (
NIL_P(beg))
return false;
2430 if (
NIL_P(end))
return false;
2431 int less = r_less(beg, end);
2433 if (less > 0)
return true;
2434 if (excl && less == 0)
return true;
2510 rb_raise(
rb_eTypeError,
"wrong argument type %"PRIsVALUE
" (expected Range)",
2514 VALUE self_beg = RANGE_BEG(range);
2515 VALUE self_end = RANGE_END(range);
2516 int self_excl = EXCL(range);
2517 VALUE other_beg = RANGE_BEG(other);
2518 VALUE other_end = RANGE_END(other);
2519 int other_excl = EXCL(other);
2521 if (empty_region_p(self_beg, other_end, other_excl))
return Qfalse;
2522 if (empty_region_p(other_beg, self_end, self_excl))
return Qfalse;
2528 if (rb_cmpint(cmp, self_beg, other_beg) == 0)
return Qtrue;
2532 return RBOOL(!
NIL_P(cmp));
2535 if (empty_region_p(self_beg, self_end, self_excl))
return Qfalse;
2536 if (empty_region_p(other_beg, other_end, other_excl))
return Qfalse;
2788 "Range", rb_cObject, range_alloc,
2789 "begin",
"end",
"excl", NULL);
#define RUBY_ASSERT(...)
Asserts that the given expression is truthy if and only if RUBY_DEBUG is truthy.
#define rb_define_method(klass, mid, func, arity)
Defines klass#mid.
void rb_include_module(VALUE klass, VALUE module)
Includes a module to a class.
int rb_scan_args(int argc, const VALUE *argv, const char *fmt,...)
Retrieves argument from argc and argv to given VALUE references according to the format string.
int rb_block_given_p(void)
Determines if the current method is given a block.
#define rb_str_new2
Old name of rb_str_new_cstr.
#define RB_INTEGER_TYPE_P
Old name of rb_integer_type_p.
#define RFLOAT_VALUE
Old name of rb_float_value.
#define T_STRING
Old name of RUBY_T_STRING.
#define Qundef
Old name of RUBY_Qundef.
#define INT2FIX
Old name of RB_INT2FIX.
#define UNREACHABLE
Old name of RBIMPL_UNREACHABLE.
#define T_FLOAT
Old name of RUBY_T_FLOAT.
#define ID2SYM
Old name of RB_ID2SYM.
#define T_BIGNUM
Old name of RUBY_T_BIGNUM.
#define SPECIAL_CONST_P
Old name of RB_SPECIAL_CONST_P.
#define CLASS_OF
Old name of rb_class_of.
#define FIXABLE
Old name of RB_FIXABLE.
#define LONG2FIX
Old name of RB_INT2FIX.
#define ASSUME
Old name of RBIMPL_ASSUME.
#define LONG2NUM
Old name of RB_LONG2NUM.
#define FIXNUM_MIN
Old name of RUBY_FIXNUM_MIN.
#define FLONUM_P
Old name of RB_FLONUM_P.
#define Qtrue
Old name of RUBY_Qtrue.
#define ST2FIX
Old name of RB_ST2FIX.
#define FIXNUM_MAX
Old name of RUBY_FIXNUM_MAX.
#define Qnil
Old name of RUBY_Qnil.
#define Qfalse
Old name of RUBY_Qfalse.
#define FIX2LONG
Old name of RB_FIX2LONG.
#define T_OBJECT
Old name of RUBY_T_OBJECT.
#define NIL_P
Old name of RB_NIL_P.
#define POSFIXABLE
Old name of RB_POSFIXABLE.
#define DBL2NUM
Old name of rb_float_new.
#define BUILTIN_TYPE
Old name of RB_BUILTIN_TYPE.
#define NUM2LONG
Old name of RB_NUM2LONG.
#define FIXNUM_P
Old name of RB_FIXNUM_P.
#define CONST_ID
Old name of RUBY_CONST_ID.
#define rb_ary_new2
Old name of rb_ary_new_capa.
#define SYMBOL_P
Old name of RB_SYMBOL_P.
void rb_iter_break(void)
Breaks from a block.
VALUE rb_eRangeError
RangeError exception.
VALUE rb_eTypeError
TypeError exception.
VALUE rb_cTime
Time class.
VALUE rb_Float(VALUE val)
This is the logic behind Kernel#Float.
VALUE rb_obj_alloc(VALUE klass)
Allocates an instance of the given class.
VALUE rb_mEnumerable
Enumerable module.
int rb_eql(VALUE lhs, VALUE rhs)
Checks for equality of the passed objects, in terms of Object#eql?.
VALUE rb_cNumeric
Numeric class.
VALUE rb_Array(VALUE val)
This is the logic behind Kernel#Array.
VALUE rb_obj_class(VALUE obj)
Queries the class of an object.
VALUE rb_inspect(VALUE obj)
Generates a human-readable textual representation of the given object.
VALUE rb_cRange
Range class.
VALUE rb_equal(VALUE lhs, VALUE rhs)
This function is an optimised version of calling #==.
VALUE rb_obj_is_kind_of(VALUE obj, VALUE klass)
Queries if the given object is an instance (of possibly descendants) of the given class.
VALUE rb_obj_freeze(VALUE obj)
Just calls rb_obj_freeze_inline() inside.
VALUE rb_check_to_integer(VALUE val, const char *mid)
Identical to rb_check_convert_type(), except the return value type is fixed to rb_cInteger.
VALUE rb_to_int(VALUE val)
Identical to rb_check_to_int(), except it raises in case of conversion mismatch.
#define RUBY_FIXNUM_MAX
Maximum possible value that a fixnum can represent.
VALUE rb_funcall(VALUE recv, ID mid, int n,...)
Calls a method.
VALUE rb_call_super(int argc, const VALUE *argv)
This resembles ruby's super.
#define RETURN_SIZED_ENUMERATOR(obj, argc, argv, size_fn)
This roughly resembles return enum_for(__callee__) unless block_given?.
#define RETURN_ENUMERATOR(obj, argc, argv)
Identical to RETURN_SIZED_ENUMERATOR(), except its size is unknown.
static int rb_check_arity(int argc, int min, int max)
Ensures that the passed integer is in the passed range.
int rb_range_values(VALUE range, VALUE *begp, VALUE *endp, int *exclp)
Deconstructs a range into its components.
VALUE rb_range_new(VALUE beg, VALUE end, int excl)
Creates a new Range.
VALUE rb_range_beg_len(VALUE range, long *begp, long *lenp, long len, int err)
Deconstructs a numerical range.
#define rb_hash_uint(h, i)
Just another name of st_hash_uint.
#define rb_hash_end(h)
Just another name of st_hash_end.
VALUE rb_str_append(VALUE dst, VALUE src)
Identical to rb_str_buf_append(), except it converts the right hand side before concatenating.
#define rb_str_new(str, len)
Allocates an instance of rb_cString.
VALUE rb_str_dup(VALUE str)
Duplicates a string.
VALUE rb_str_cat(VALUE dst, const char *src, long srclen)
Destructively appends the passed contents to the string.
st_index_t rb_hash_start(st_index_t i)
Starts a series of hashing.
VALUE rb_check_string_type(VALUE obj)
Try converting an object to its stringised representation using its to_str method,...
VALUE rb_str_intern(VALUE str)
Identical to rb_to_symbol(), except it assumes the receiver being an instance of RString.
VALUE rb_obj_as_string(VALUE obj)
Try converting an object to its stringised representation using its to_s method, if any.
VALUE rb_struct_define_without_accessor(const char *name, VALUE super, rb_alloc_func_t func,...)
Identical to rb_struct_define(), except it does not define accessor methods.
VALUE rb_struct_alloc_noinit(VALUE klass)
Allocates an instance of the given class.
VALUE rb_exec_recursive(VALUE(*f)(VALUE g, VALUE h, int r), VALUE g, VALUE h)
"Recursion" API entry point.
VALUE rb_exec_recursive_paired(VALUE(*f)(VALUE g, VALUE h, int r), VALUE g, VALUE p, VALUE h)
Identical to rb_exec_recursive(), except it checks for the recursion on the ordered pair of { g,...
VALUE rb_ivar_set(VALUE obj, ID name, VALUE val)
Identical to rb_iv_set(), except it accepts the name as an ID instead of a C string.
VALUE rb_ivar_get(VALUE obj, ID name)
Identical to rb_iv_get(), except it accepts the name as an ID instead of a C string.
VALUE rb_class_name(VALUE obj)
Queries the name of the given object's class.
int rb_respond_to(VALUE obj, ID mid)
Queries if the object responds to the method.
VALUE rb_check_funcall(VALUE recv, ID mid, int argc, const VALUE *argv)
Identical to rb_funcallv(), except it returns RUBY_Qundef instead of raising rb_eNoMethodError.
static ID rb_intern_const(const char *str)
This is a "tiny optimisation" over rb_intern().
VALUE rb_sym2str(VALUE symbol)
Obtain a frozen string representation of a symbol (not including the leading colon).
int len
Length of the buffer.
#define RB_BLOCK_CALL_FUNC_ARGLIST(yielded_arg, callback_arg)
Shim for block function parameters.
VALUE rb_yield(VALUE val)
Yields the block.
void rb_marshal_define_compat(VALUE newclass, VALUE oldclass, VALUE(*dumper)(VALUE), VALUE(*loader)(VALUE, VALUE))
Marshal format compatibility layer.
VALUE rb_block_call(VALUE q, ID w, int e, const VALUE *r, type *t, VALUE y)
Call a method with a block.
VALUE rb_rescue2(type *q, VALUE w, type *e, VALUE r,...)
An equivalent of rescue clause.
#define RBIMPL_ATTR_NORETURN()
Wraps (or simulates) [[noreturn]]
#define RARRAY_AREF(a, i)
#define RBASIC(obj)
Convenient casting macro.
#define RBIGNUM_SIGN
Just another name of rb_big_sign.
static bool RBIGNUM_NEGATIVE_P(VALUE b)
Checks if the bignum is negative.
static bool RBIGNUM_POSITIVE_P(VALUE b)
Checks if the bignum is positive.
const char * rb_obj_classname(VALUE obj)
Queries the name of the class of the passed object.
#define RTEST
This is an old name of RB_TEST.
uintptr_t ID
Type that represents a Ruby identifier such as a variable name.
uintptr_t VALUE
Type that represents a Ruby object.
static bool RB_FLOAT_TYPE_P(VALUE obj)
Queries if the object is an instance of rb_cFloat.
static bool rb_integer_type_p(VALUE obj)
Queries if the object is an instance of rb_cInteger.
static bool RB_TYPE_P(VALUE obj, enum ruby_value_type t)
Queries if the given object is of given type.