Ruby 3.5.0dev (2025-05-22 revision 7b10660974dcdd7882a48a62cfc2a32c4a17aa85)
internal.h (7b10660974dcdd7882a48a62cfc2a32c4a17aa85)
1#ifndef RUBY_INTERNAL_H /*-*-C-*-vi:se ft=c:*/
2#define RUBY_INTERNAL_H 1
12#include "ruby/internal/config.h"
13
14#ifdef __cplusplus
15# error not for C++
16#endif
17
18#define LIKELY(x) RB_LIKELY(x)
19#define UNLIKELY(x) RB_UNLIKELY(x)
20
21#define numberof(array) ((int)(sizeof(array) / sizeof((array)[0])))
22#define roomof(x, y) (((x) + (y) - 1) / (y))
23#define type_roomof(x, y) roomof(sizeof(x), sizeof(y))
24
25/* Prevent compiler from reordering access */
26#define ACCESS_ONCE(type,x) (*((volatile type *)&(x)))
27
28#define UNDEF_P RB_UNDEF_P
29#define NIL_OR_UNDEF_P RB_NIL_OR_UNDEF_P
30
31#include "ruby/ruby.h"
32
33/* Following macros were formerly defined in this header but moved to somewhere
34 * else. In order to detect them we undef here. */
35
36/* internal/array.h */
37#undef RARRAY_AREF
38
39/* internal/class.h */
40#undef RClass
41#undef RCLASS_SUPER
42
43/* internal/hash.h */
44#undef RHASH_IFNONE
45#undef RHASH_SIZE
46#undef RHASH_TBL
47#undef RHASH_EMPTY_P
48
49/* internal/struct.h */
50#undef RSTRUCT_LEN
51#undef RSTRUCT_PTR
52#undef RSTRUCT_SET
53#undef RSTRUCT_GET
54
55/* Also, we keep the following macros here. They are expected to be
56 * overridden in each headers. */
57
58/* internal/array.h */
59#define rb_ary_new_from_args(...) rb_nonexistent_symbol(__VA_ARGS__)
60
61/* internal/string.h */
62#define rb_fstring_cstr(...) rb_nonexistent_symbol(__VA_ARGS__)
63
64/* internal/symbol.h */
65#define rb_sym_intern_ascii_cstr(...) rb_nonexistent_symbol(__VA_ARGS__)
66
67/* internal/vm.h */
68#define rb_funcallv(...) rb_nonexistent_symbol(__VA_ARGS__)
69#define rb_method_basic_definition_p(...) rb_nonexistent_symbol(__VA_ARGS__)
70
71
72/* MRI debug support */
73
74/* gc.c */
75void rb_obj_info_dump(VALUE obj);
76void rb_obj_info_dump_loc(VALUE obj, const char *file, int line, const char *func);
77
78/* debug.c */
79
80RUBY_SYMBOL_EXPORT_BEGIN
81void ruby_debug_breakpoint(void);
82PRINTF_ARGS(void ruby_debug_printf(const char*, ...), 1, 2);
83RUBY_SYMBOL_EXPORT_END
84
85// show obj data structure without any side-effect
86#define rp(obj) rb_obj_info_dump_loc((VALUE)(obj), __FILE__, __LINE__, RUBY_FUNCTION_NAME_STRING)
87
88// same as rp, but add message header
89#define rp_m(msg, obj) do { \
90 fputs((msg), stderr); \
91 rb_obj_info_dump((VALUE)(obj)); \
92} while (0)
93
94// `ruby_debug_breakpoint()` does nothing,
95// but breakpoint is set in run.gdb, so `make gdb` can stop here.
96#define bp() ruby_debug_breakpoint()
97
98#define RBOOL(v) ((v) ? Qtrue : Qfalse)
99#define RB_BIGNUM_TYPE_P(x) RB_TYPE_P((x), T_BIGNUM)
100
101#ifndef __MINGW32__
102#undef memcpy
103#define memcpy ruby_nonempty_memcpy
104#endif
105#endif /* RUBY_INTERNAL_H */
uintptr_t VALUE
Type that represents a Ruby object.
Definition value.h:40