Ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e0ba6b95ab71a441357ed5484e33498)
eval_jump.c
1/* -*-c-*- */
2/*
3 * from eval.c
4 */
5
6#include "eval_intern.h"
7
8/* exit */
9
10void
11rb_call_end_proc(VALUE data)
12{
13 rb_proc_call(data, rb_ary_new());
14}
15
16/*
17 * call-seq:
18 * at_exit { block } -> proc
19 *
20 * Converts _block_ to a +Proc+ object (and therefore
21 * binds it at the point of call) and registers it for execution when
22 * the program exits. If multiple handlers are registered, they are
23 * executed in reverse order of registration.
24 *
25 * def do_at_exit(str1)
26 * at_exit { print str1 }
27 * end
28 * at_exit { puts "cruel world" }
29 * do_at_exit("goodbye ")
30 * exit
31 *
32 * <em>produces:</em>
33 *
34 * goodbye cruel world
35 */
36
37static VALUE
38rb_f_at_exit(VALUE _)
39{
40 VALUE proc;
41
42 if (!rb_block_given_p()) {
43 rb_raise(rb_eArgError, "called without a block");
44 }
45 proc = rb_block_proc();
46 rb_set_end_proc(rb_call_end_proc, proc);
47 return proc;
48}
49
51 void (*func) (VALUE);
52 VALUE data;
53 struct end_proc_data *next;
54};
55
56static struct end_proc_data *end_procs, *ephemeral_end_procs;
57
58void
59rb_set_end_proc(void (*func)(VALUE), VALUE data)
60{
61 struct end_proc_data *link = ALLOC(struct end_proc_data);
62 struct end_proc_data **list;
63 rb_thread_t *th = GET_THREAD();
64
65 if (th->top_wrapper) {
66 list = &ephemeral_end_procs;
67 }
68 else {
69 list = &end_procs;
70 }
71 link->next = *list;
72 link->func = func;
73 link->data = data;
74 *list = link;
75}
76
77void
78rb_mark_end_proc(void)
79{
80 struct end_proc_data *link;
81
82 link = end_procs;
83 while (link) {
84 rb_gc_mark(link->data);
85 link = link->next;
86 }
87 link = ephemeral_end_procs;
88 while (link) {
89 rb_gc_mark(link->data);
90 link = link->next;
91 }
92}
93
94static void
95exec_end_procs_chain(struct end_proc_data *volatile *procs, VALUE *errp)
96{
97 struct end_proc_data volatile endproc;
98 struct end_proc_data *link;
99 VALUE errinfo = *errp;
100
101 while ((link = *procs) != 0) {
102 *procs = link->next;
103 endproc = *link;
104 xfree(link);
105 (*endproc.func) (endproc.data);
106 *errp = errinfo;
107 }
108}
109
110static void
111rb_ec_exec_end_proc(rb_execution_context_t * ec)
112{
113 enum ruby_tag_type state;
114 volatile VALUE errinfo = ec->errinfo;
115
116 EC_PUSH_TAG(ec);
117 if ((state = EC_EXEC_TAG()) == TAG_NONE) {
118 again:
119 exec_end_procs_chain(&ephemeral_end_procs, &ec->errinfo);
120 exec_end_procs_chain(&end_procs, &ec->errinfo);
121 }
122 else {
123 EC_TMPPOP_TAG();
124 error_handle(ec, state);
125 if (!NIL_P(ec->errinfo)) errinfo = ec->errinfo;
126 EC_REPUSH_TAG();
127 goto again;
128 }
129 EC_POP_TAG();
130
131 ec->errinfo = errinfo;
132}
133
134void
135Init_jump(void)
136{
137 rb_define_global_function("at_exit", rb_f_at_exit, 0);
138}
int rb_block_given_p(void)
Determines if the current method is given a block.
Definition: eval.c:850
void rb_define_global_function(const char *name, VALUE(*func)(ANYARGS), int argc)
Defines a global function.
Definition: class.c:2110
#define ALLOC
Old name of RB_ALLOC.
Definition: memory.h:394
#define xfree
Old name of ruby_xfree.
Definition: xmalloc.h:58
#define NIL_P
Old name of RB_NIL_P.
void rb_raise(VALUE exc, const char *fmt,...)
Exception entry point.
Definition: error.c:3021
VALUE rb_ary_new(void)
Allocates a new, empty array.
Definition: array.c:750
void rb_set_end_proc(void(*func)(VALUE arg), VALUE arg)
Registers a function that shall run on process exit.
void rb_gc_mark(VALUE obj)
Marks an object.
Definition: gc.c:6774
VALUE rb_proc_call(VALUE recv, VALUE args)
Evaluates the passed proc with the passed arguments.
Definition: proc.c:1003
VALUE rb_block_proc(void)
Constructs a Proc object from implicitly passed components.
Definition: proc.c:848
#define _(args)
This was a transition path from K&R to ANSI.
Definition: stdarg.h:35
uintptr_t VALUE
Type that represents a Ruby object.
Definition: value.h:40