Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 709 lines (549 sloc) 20.255 kb
540a832 @jkeenan [codingstd] Mostly linelength fixes.
jkeenan authored
1 /*
2f0e851 @petdance const a local variable. Minor spacing tweaks
petdance authored
2 Copyright (C) 2010-2012, Parrot Foundation.
540a832 @jkeenan [codingstd] Mostly linelength fixes.
jkeenan authored
3
4 =head1 NAME
5
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
6 src/embed/api.c - The Parrot embedding interface
540a832 @jkeenan [codingstd] Mostly linelength fixes.
jkeenan authored
7
8 =head1 DESCRIPTION
9
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
10 This file implements functions of the Parrot embedding interface.
11
12 =head2 Functions
13
14 =over 4
540a832 @jkeenan [codingstd] Mostly linelength fixes.
jkeenan authored
15
16 =cut
17
18 */
19
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
20 #include "parrot/parrot.h"
704e3c4 @bluescreen10 Made another test case pass by putting debug information. Also removed s...
bluescreen10 authored
21 #include "parrot/runcore_api.h"
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
22 #include "parrot/api.h"
1b6d1ce @Whiteknight start breaking up the embedding stuff into multiple files. Add embed_pri...
Whiteknight authored
23 #include "embed_private.h"
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
24
3f8ed92 @Whiteknight fix some file references and run headerizer to see my work so far
Whiteknight authored
25 /* HEADERIZER HFILE: include/parrot/api.h */
26
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
27
28 /*
29
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
30 =item C<Parrot_Int Parrot_api_get_result(Parrot_PMC interp_pmc, Parrot_Int
2f0e851 @petdance const a local variable. Minor spacing tweaks
petdance authored
31 *is_error, Parrot_PMC *exception, Parrot_Int *exit_code, Parrot_String *errmsg)>
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
32
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
33 Gets the results of the last API function call and stores the results in
34 C<is_error>, C<exception>, C<exit_code> and C<errmsg>. This function returns
35 a true value if this call is successful and false value otherwise. The stored
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
36 information is as follows:
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
37
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
38 C<is_error> a true value if an unhandled exception was thrown or the program
39 terminated with an error condition and a false value otherwise.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
40
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
41 C<exception> the last exception thrown, PMCNULL if none.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
42
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
43 C<exit_code> the exit code of the running program, if it expected to exit
44 now. C<0> for no error.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
45
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
46 C<errmsg> contains an string with the last error message if any,
47 C<STRINGNULL> if none.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
48
49 =cut
50
51 */
52
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
53 PARROT_API
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
54 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
55 Parrot_api_get_result(Parrot_PMC interp_pmc, ARGOUT(Parrot_Int *is_error),
2f0e851 @petdance const a local variable. Minor spacing tweaks
petdance authored
56 ARGOUT(Parrot_PMC *exception), ARGOUT(Parrot_Int *exit_code),
57 ARGOUT(Parrot_String *errmsg))
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
58 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
59 ASSERT_ARGS(Parrot_api_get_result)
2483c68 @Whiteknight implement the new error-handling mechanism. Instead of a string, we pass...
Whiteknight authored
60 EMBED_API_CALLIN(interp_pmc, interp)
be50d63 @bluescreen10 Implemented first version of Parrot_get_result, now a lot of failing tes...
bluescreen10 authored
61 *exit_code = interp->exit_code;
2483c68 @Whiteknight implement the new error-handling mechanism. Instead of a string, we pass...
Whiteknight authored
62 *exception = interp->final_exception;
73f662d @Whiteknight some fixes so libparrot builds with g++
Whiteknight authored
63 if (PMC_IS_NULL(*exception)) {
2483c68 @Whiteknight implement the new error-handling mechanism. Instead of a string, we pass...
Whiteknight authored
64 *is_error = 0;
65 *errmsg = STRINGNULL;
9703ef5 @jkeenan [codingstd] C-style coda needed. No cuddled elses.
jkeenan authored
66 }
67 else {
b3af8c9 @Whiteknight fix main.c so that we check the is_error flag and only show an error mes...
Whiteknight authored
68 STRING * const severity_str = Parrot_str_new(interp, "severity", 0);
2f0e851 @petdance const a local variable. Minor spacing tweaks
petdance authored
69 const INTVAL severity = VTABLE_get_integer_keyed_str(interp, *exception, severity_str);
b3af8c9 @Whiteknight fix main.c so that we check the is_error flag and only show an error mes...
Whiteknight authored
70 *is_error = (severity != EXCEPT_exit);
2483c68 @Whiteknight implement the new error-handling mechanism. Instead of a string, we pass...
Whiteknight authored
71 *errmsg = VTABLE_get_string(interp, *exception);
72 }
73 interp->final_exception = PMCNULL;
be50d63 @bluescreen10 Implemented first version of Parrot_get_result, now a lot of failing tes...
bluescreen10 authored
74 interp->exit_code = 0;
2483c68 @Whiteknight implement the new error-handling mechanism. Instead of a string, we pass...
Whiteknight authored
75 EMBED_API_CALLOUT(interp_pmc, interp)
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
76 }
77
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
78 /*
79
80 =item C<Parrot_Int Parrot_api_get_exception_backtrace(Parrot_PMC interp_pmc,
2f0e851 @petdance const a local variable. Minor spacing tweaks
petdance authored
81 Parrot_PMC exception, Parrot_String *bt)>
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
82
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
83 Gets the backtrace of the interpreter's call chain for the given exception
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
84 C<exception> and stores the results in string C<bt>. This function returns a
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
85 true value if this call is successful and false value otherwise.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
86
87 =cut
88
89 */
90
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
91 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
92 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
93 Parrot_api_get_exception_backtrace(Parrot_PMC interp_pmc,
2f0e851 @petdance const a local variable. Minor spacing tweaks
petdance authored
94 Parrot_PMC exception, ARGOUT(Parrot_String *bt))
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
95 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
96 ASSERT_ARGS(Parrot_api_get_exception_backtrace)
2483c68 @Whiteknight implement the new error-handling mechanism. Instead of a string, we pass...
Whiteknight authored
97 EMBED_API_CALLIN(interp_pmc, interp)
3c6f7d0 @Whiteknight rethrow caches the old backtrace.
Whiteknight authored
98 if (PMC_IS_NULL(exception))
99 *bt = STRINGNULL;
100 else
0a4f093 @Whiteknight build fixes
Whiteknight authored
101 *bt = Parrot_ex_build_complete_backtrace_string(interp, exception);
2483c68 @Whiteknight implement the new error-handling mechanism. Instead of a string, we pass...
Whiteknight authored
102 EMBED_API_CALLOUT(interp_pmc, interp)
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
103 }
104
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
105
106 /*
107
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
108 =item C<Parrot_Int Parrot_api_make_interpreter(Parrot_PMC parent, Parrot_Int
109 flags, Parrot_Init_Args *args, Parrot_PMC *interp)>
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
110
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
111 Creates a new interpreter and stores it in C<interp>. It takes three optional
112 parameters the new interpreter's C<flags>, the initialization paremeters C<args>
113 and the C<parent> interpreter. This function returns a true value if this call
114 is successful and false value otherwise.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
115
116 =cut
117
118 */
119
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
120 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
121 Parrot_Int
709eae7 @Whiteknight add in a handful of additional API functions, though they aren't being u...
Whiteknight authored
122 Parrot_api_make_interpreter(Parrot_PMC parent, Parrot_Int flags,
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
123 ARGIN_NULLOK(Parrot_Init_Args *args), ARGOUT(Parrot_PMC *interp))
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
124 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
125 ASSERT_ARGS(Parrot_api_make_interpreter)
4a128d5 @Whiteknight lots of little changes
Whiteknight authored
126 int alt_stacktop;
c1ab56e More fixes, almost there
Mariano Wahlmann authored
127 Parrot_Interp interp_raw;
9b2b656 @nwellnhof Add minimum GC threshold option
nwellnhof authored
128 Parrot_GC_Init_Args gc_args;
82cbd84 @Whiteknight parrot executable compiles, but miniparrot does not link. I need to sort...
Whiteknight authored
129 const Parrot_Interp parent_raw = PMC_IS_NULL(parent) ? NULL : GET_RAW_INTERP(parent);
7a315db @Whiteknight set an api jump buffer in Parrot_api_make_interpreter, so we can try to ...
Whiteknight authored
130 Parrot_jump_buff env;
86353cc @bilalakhtar More function renames, now stuck at PIR files
bilalakhtar authored
131 interp_raw = Parrot_interp_allocate_interpreter(parent_raw, flags);
7a315db @Whiteknight set an api jump buffer in Parrot_api_make_interpreter, so we can try to ...
Whiteknight authored
132 if (setjmp(env)) {
133 interp_raw->api_jmp_buf = NULL;
69ee128 @Whiteknight if we don't have an interp, print out an error message. If we do, try to...
Whiteknight authored
134 *interp = NULL;
7a315db @Whiteknight set an api jump buffer in Parrot_api_make_interpreter, so we can try to ...
Whiteknight authored
135 return !interp_raw->exit_code;
f2252b4 @Whiteknight remove the two-stage initialization dance. We can now initialize an inte...
Whiteknight authored
136 }
400feae @nwellnhof Merge branch 'master' into nwellnhof/gc_dynamic_threshold
nwellnhof authored
137 else {
7a315db @Whiteknight set an api jump buffer in Parrot_api_make_interpreter, so we can try to ...
Whiteknight authored
138 interp_raw->api_jmp_buf = &env;
139 if (args) {
140 gc_args.stacktop = args->stacktop
141 ? args->stacktop : &alt_stacktop;
142 gc_args.system = args->gc_system;
143 gc_args.nursery_size = args->gc_nursery_size;
144 gc_args.dynamic_threshold = args->gc_dynamic_threshold;
145 gc_args.min_threshold = args->gc_min_threshold;
146
147 if (args->hash_seed)
148 interp_raw->hash_seed = args->hash_seed;
149 }
150 else {
151 memset(&gc_args, 0, sizeof (Parrot_GC_Init_Args));
152 gc_args.stacktop = &alt_stacktop;
153 }
e85966a @bilalakhtar Rename functions yet again...
bilalakhtar authored
154 Parrot_interp_initialize_interpreter(interp_raw, &gc_args);
7a315db @Whiteknight set an api jump buffer in Parrot_api_make_interpreter, so we can try to ...
Whiteknight authored
155 *interp = VTABLE_get_pmc_keyed_int(
156 interp_raw, interp_raw->iglobals, (Parrot_Int)IGLOBALS_INTERPRETER);
400feae @nwellnhof Merge branch 'master' into nwellnhof/gc_dynamic_threshold
nwellnhof authored
157 }
7a315db @Whiteknight set an api jump buffer in Parrot_api_make_interpreter, so we can try to ...
Whiteknight authored
158 interp_raw->api_jmp_buf = NULL;
f2252b4 @Whiteknight remove the two-stage initialization dance. We can now initialize an inte...
Whiteknight authored
159 return !PMC_IS_NULL(*interp);
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
160 }
161
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
162 /*
163
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
164 =item C<Parrot_Int Parrot_api_set_runcore(Parrot_PMC interp_pmc, const char *
165 corename, Parrot_UInt trace)>
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
166
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
167 Sets the C<interp_pmc>'s bytecode running core, the core is specified by the
168 C<corename>. This function returns a true value if this call is successful and
169 false value otherwise.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
170
171 =cut
172
173 */
174
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
175 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
176 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
177 Parrot_api_set_runcore(Parrot_PMC interp_pmc, ARGIN(const char * corename),
178 Parrot_UInt trace)
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
179 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
180 ASSERT_ARGS(Parrot_api_set_runcore)
3ea891c First round of syntax error fixes
Mariano Wahlmann authored
181 EMBED_API_CALLIN(interp_pmc, interp)
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
182 if (trace) {
c510c5c @Whiteknight fix the trace core, so when we use the -t, --trace, or -Rtrace flags, it...
Whiteknight authored
183 Interp_trace_SET(interp, PARROT_TRACE_OPS_FLAG);
704e3c4 @bluescreen10 Made another test case pass by putting debug information. Also removed s...
bluescreen10 authored
184 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "slow"));
9703ef5 @jkeenan [codingstd] C-style coda needed. No cuddled elses.
jkeenan authored
185 }
186 else {
38e5177 @petdance Use STREQ() for string comparisons, instead of incorrectly using strcmp ...
petdance authored
187 if (STREQ(corename, "slow") || STREQ(corename, "bounds"))
704e3c4 @bluescreen10 Made another test case pass by putting debug information. Also removed s...
bluescreen10 authored
188 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "slow"));
38e5177 @petdance Use STREQ() for string comparisons, instead of incorrectly using strcmp ...
petdance authored
189 else if (STREQ(corename, "fast") || STREQ(corename, "jit") || STREQ(corename, "function"))
704e3c4 @bluescreen10 Made another test case pass by putting debug information. Also removed s...
bluescreen10 authored
190 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "fast"));
f5d74c4 @mlschroe subprof_fun -> subprof_sub, headerize
mlschroe authored
191 else if (STREQ(corename, "subprof_sub"))
192 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "subprof_sub"));
f5358a8 @mlschroe move global subprofdata into the runcore data for now. dump profile data...
mlschroe authored
193 else if (STREQ(corename, "subprof_hll") || STREQ(corename, "subprof"))
beef84c @mlschroe support subprof_fun, subprof_hll, subprof_ops
mlschroe authored
194 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "subprof_hll"));
195 else if (STREQ(corename, "subprof_ops"))
196 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "subprof_ops"));
38e5177 @petdance Use STREQ() for string comparisons, instead of incorrectly using strcmp ...
petdance authored
197 else if (STREQ(corename, "exec"))
704e3c4 @bluescreen10 Made another test case pass by putting debug information. Also removed s...
bluescreen10 authored
198 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "exec"));
114d897 @petdance Use STREQ() for string comparisons, instead of incorrectly using strcmp ...
petdance authored
199 else if (STREQ(corename, "trace"))
704e3c4 @bluescreen10 Made another test case pass by putting debug information. Also removed s...
bluescreen10 authored
200 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "slow"));
38e5177 @petdance Use STREQ() for string comparisons, instead of incorrectly using strcmp ...
petdance authored
201 else if (STREQ(corename, "profiling"))
704e3c4 @bluescreen10 Made another test case pass by putting debug information. Also removed s...
bluescreen10 authored
202 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "profiling"));
38e5177 @petdance Use STREQ() for string comparisons, instead of incorrectly using strcmp ...
petdance authored
203 else if (STREQ(corename, "gcdebug"))
704e3c4 @bluescreen10 Made another test case pass by putting debug information. Also removed s...
bluescreen10 authored
204 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "gcdebug"));
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
205 else
206 Parrot_ex_throw_from_c_args(interp, NULL, 1, "Invalid runcore type %s", corename);
207 }
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
208 EMBED_API_CALLOUT(interp_pmc, interp)
209 }
210
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
211 /*
212
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
213 =item C<Parrot_Int Parrot_api_debug_flag(Parrot_PMC interp_pmc, Parrot_Int
214 flags, Parrot_Int set)>
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
215
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
216 Sets/Unsets the C<interp_pmc>'s debug flags. If C<set> is in a true value debug
217 flags are set otherwise debug flags are cleared. This function returns a true
218 value if this call is successful and false value otherwise.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
219
220 =cut
221
222 */
223
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
224 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
225 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
226 Parrot_api_debug_flag(Parrot_PMC interp_pmc, Parrot_Int flags, Parrot_Int set)
f68bf56 @Whiteknight add Parrot_api_flag and Parrot_api_debug_flag. Use these in main.c inste...
Whiteknight authored
227 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
228 ASSERT_ARGS(Parrot_api_debug_flag)
c1ab56e More fixes, almost there
Mariano Wahlmann authored
229 EMBED_API_CALLIN(interp_pmc, interp)
f68bf56 @Whiteknight add Parrot_api_flag and Parrot_api_debug_flag. Use these in main.c inste...
Whiteknight authored
230 if (set)
231 interp->debug_flags |= flags;
232 else
233 interp->debug_flags &= ~flags;
234 EMBED_API_CALLOUT(interp_pmc, interp);
235 }
236
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
237 /*
238
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
239 =item C<Parrot_Int Parrot_api_flag(Parrot_PMC interp_pmc, Parrot_Int flags,
240 Parrot_Int set)>
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
241
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
242 Set/Unset the C<interp_pmc>'s general flags. If C<set> is in a true value general
243 flags are set otherwise passed flags are cleared. This function returns a true
244 value if this call is successful and false value otherwise.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
245
246 =cut
247
248 */
249
f68bf56 @Whiteknight add Parrot_api_flag and Parrot_api_debug_flag. Use these in main.c inste...
Whiteknight authored
250 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
251 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
252 Parrot_api_flag(Parrot_PMC interp_pmc, Parrot_Int flags, Parrot_Int set)
f68bf56 @Whiteknight add Parrot_api_flag and Parrot_api_debug_flag. Use these in main.c inste...
Whiteknight authored
253 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
254 ASSERT_ARGS(Parrot_api_flag)
c1ab56e More fixes, almost there
Mariano Wahlmann authored
255 EMBED_API_CALLIN(interp_pmc, interp)
f68bf56 @Whiteknight add Parrot_api_flag and Parrot_api_debug_flag. Use these in main.c inste...
Whiteknight authored
256 if (set) {
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
257 Interp_flags_SET(interp, flags);
258 if (flags & (PARROT_BOUNDS_FLAG | PARROT_PROFILE_FLAG))
f68bf56 @Whiteknight add Parrot_api_flag and Parrot_api_debug_flag. Use these in main.c inste...
Whiteknight authored
259 Parrot_runcore_switch(interp, Parrot_str_new_constant(interp, "slow"));
260 }
261 else
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
262 Interp_flags_CLEAR(interp, flags);
f68bf56 @Whiteknight add Parrot_api_flag and Parrot_api_debug_flag. Use these in main.c inste...
Whiteknight authored
263 EMBED_API_CALLOUT(interp_pmc, interp);
264 }
265
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
266 /*
267
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
268 =item C<Parrot_Int Parrot_api_set_executable_name(Parrot_PMC interp_pmc, const
2f0e851 @petdance const a local variable. Minor spacing tweaks
petdance authored
269 char *name)>
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
270
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
271 Sets the executable name for the C<interp_pmc> interpreter. This function returns
272 a true value if this call is successful and false value otherwise.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
273
274 =cut
275
276 */
277
f68bf56 @Whiteknight add Parrot_api_flag and Parrot_api_debug_flag. Use these in main.c inste...
Whiteknight authored
278 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
279 Parrot_Int
2f0e851 @petdance const a local variable. Minor spacing tweaks
petdance authored
280 Parrot_api_set_executable_name(Parrot_PMC interp_pmc, ARGIN(const char *name))
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
281 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
282 ASSERT_ARGS(Parrot_api_set_executable_name)
c1ab56e More fixes, almost there
Mariano Wahlmann authored
283 EMBED_API_CALLIN(interp_pmc, interp)
9cc3ace @plobsing allow for unicode names of fakecutables
plobsing authored
284 STRING * const name_str = Parrot_str_from_platform_cstring(interp, name);
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
285 PMC * const name_pmc = Parrot_pmc_new(interp, enum_class_String);
1a692e9 @Whiteknight _set_executable_name takes a C string instead of a Parrot string, for co...
Whiteknight authored
286 VTABLE_set_string_native(interp, name_pmc, name_str);
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
287 VTABLE_set_pmc_keyed_int(interp, interp->iglobals, IGLOBALS_EXECUTABLE,
288 name_pmc);
4a128d5 @Whiteknight lots of little changes
Whiteknight authored
289 EMBED_API_CALLOUT(interp_pmc, interp);
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
290 }
291
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
292 /*
293
294 =item C<Parrot_Int Parrot_api_destroy_interpreter(Parrot_PMC interp_pmc)>
295
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
296 Destroys the C<interp_pmc> interpreter, freeing the memory structures allocated
297 for it. This function returns a true value if this call is successful and false
298 value otherwise.
3653784 @bluescreen10 Embed API Documentation round 1
bluescreen10 authored
299
300 =cut
301
302 */
303
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
304 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
305 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
306 Parrot_api_destroy_interpreter(Parrot_PMC interp_pmc)
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
307 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
308 ASSERT_ARGS(Parrot_api_destroy_interpreter)
2dc5187 @nwellnhof [embed] Fix segfault with --leak-test option
nwellnhof authored
309 Parrot_jump_buff env;
310 if (setjmp(env)) {
311 /* We can't check for potential errors because the interpreter
312 * might have been destroyed. */
313 return 1;
314 }
315 else {
ced54a5 @NotFound Fix remaining 'might be clobbered' warning
NotFound authored
316 Interp * const interp = GET_INTERP(interp_pmc);
317 void * _oldtop = interp->lo_var_ptr;
318 if (_oldtop == NULL)
319 interp->lo_var_ptr = &_oldtop;
320 interp->api_jmp_buf = &env;
0b7ccce @Whiteknight Add a new Parrot_x_execute_on_exit_handlers to call exit handlers. Use t...
Whiteknight authored
321 Parrot_x_execute_on_exit_handlers(interp, 0);
e85966a @bilalakhtar Rename functions yet again...
bilalakhtar authored
322 Parrot_interp_destroy(interp);
2dc5187 @nwellnhof [embed] Fix segfault with --leak-test option
nwellnhof authored
323 return 1;
324 }
687438e @Whiteknight add in the prototype embedding API functions I've been playing with
Whiteknight authored
325 }
326
327 /*
328
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
329 =item C<Parrot_Int Parrot_api_set_warnings(Parrot_PMC interp_pmc, Parrot_Int
330 flags)>
331
332 Enables C<inter_pmc>'s warning messages the type of warning information to be
333 print out is specified by C<flags>. This function returns a true value if this
334 call is successful and false value otherwise.
335
336 =cut
337
338 */
339
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
340 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
341 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
342 Parrot_api_set_warnings(Parrot_PMC interp_pmc, Parrot_Int flags)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
343 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
344 ASSERT_ARGS(Parrot_api_set_warnings)
c1ab56e More fixes, almost there
Mariano Wahlmann authored
345 EMBED_API_CALLIN(interp_pmc, interp)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
346 /* Activates the given warnings. (Macro from warnings.h.) */
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
347 PARROT_WARNINGS_on(interp, flags);
c1ab56e More fixes, almost there
Mariano Wahlmann authored
348 EMBED_API_CALLOUT(interp_pmc, interp)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
349 }
350
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
351 /*
352
353 =item C<Parrot_Int Parrot_api_add_library_search_path(Parrot_PMC interp_pmc,
354 const char *path)>
355
356 Adds C<path> to the C<inter_pmc>'s library search path list. This function
357 returns a true value if this call is successful and false value otherwise.
358
359 =cut
360
361 */
362
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
363 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
364 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
365 Parrot_api_add_library_search_path(Parrot_PMC interp_pmc,
366 ARGIN(const char *path))
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
367 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
368 ASSERT_ARGS(Parrot_api_add_library_search_path)
c1ab56e More fixes, almost there
Mariano Wahlmann authored
369 EMBED_API_CALLIN(interp_pmc, interp)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
370 Parrot_lib_add_path_from_cstring(interp, path, PARROT_LIB_PATH_LIBRARY);
229a781 @Whiteknight Add experimental ability to modify PARROT_LIB_PATH_LANG with the -L comm...
Whiteknight authored
371
372 /* EXPERIMENTAL. This line has been added experimentally because it is a
373 missing feature, and it may go away at any time without warning. */
374 Parrot_lib_add_path_from_cstring(interp, path, PARROT_LIB_PATH_LANG);
c1ab56e More fixes, almost there
Mariano Wahlmann authored
375 EMBED_API_CALLOUT(interp_pmc, interp)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
376 }
377
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
378 /*
379
380 =item C<Parrot_Int Parrot_api_add_include_search_path(Parrot_PMC interp_pmc,
381 const char *path)>
382
383 Adds C<path> to the C<inter_pmc>'s include search path list. This function
384 returns a true value if this call is successful and false value otherwise.
385
386 =cut
387
388 */
389
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
390 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
391 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
392 Parrot_api_add_include_search_path(Parrot_PMC interp_pmc,
393 ARGIN(const char *path))
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
394 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
395 ASSERT_ARGS(Parrot_api_add_include_search_path)
c1ab56e More fixes, almost there
Mariano Wahlmann authored
396 EMBED_API_CALLIN(interp_pmc, interp)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
397 Parrot_lib_add_path_from_cstring(interp, path, PARROT_LIB_PATH_INCLUDE);
c1ab56e More fixes, almost there
Mariano Wahlmann authored
398 EMBED_API_CALLOUT(interp_pmc, interp)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
399 }
400
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
401 /*
402
403 =item C<Parrot_Int Parrot_api_add_dynext_search_path(Parrot_PMC interp_pmc,
404 const char *path)>
405
406 Adds C<path> to the C<inter_pmc>'s dynext search path list. This function
407 returns a true value if this call is successful and false value otherwise.
408
409 =cut
410
411 */
412
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
413 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
414 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
415 Parrot_api_add_dynext_search_path(Parrot_PMC interp_pmc,
416 ARGIN(const char *path))
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
417 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
418 ASSERT_ARGS(Parrot_api_add_dynext_search_path)
c1ab56e More fixes, almost there
Mariano Wahlmann authored
419 EMBED_API_CALLIN(interp_pmc, interp)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
420 Parrot_lib_add_path_from_cstring(interp, path, PARROT_LIB_PATH_DYNEXT);
c1ab56e More fixes, almost there
Mariano Wahlmann authored
421 EMBED_API_CALLOUT(interp_pmc, interp)
9d25cd4 @Whiteknight change the imcc_run function to return a PackFile PMC so we can use it w...
Whiteknight authored
422 }
3259cda First cut of Parrot_api_set_stdhandles API function
Mariano Wahlmann authored
423
424 /*
425
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
426 =item C<Parrot_Int Parrot_api_set_stdhandle(Parrot_PMC interp_pmc, Parrot_PMC
427 handle, Parrot_Int fileno, Parrot_PMC *old_handle)>
3259cda First cut of Parrot_api_set_stdhandles API function
Mariano Wahlmann authored
428
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
429 Set one of the C<interp_pmc>'s standard IO PMCs. The handle PMC C<handle> is
430 an IO-type PMC (such as FileHandle or StringHandle). The fileno is one of
431 C<0> for stdin, C<1> for stdout and C<2> for stderr. Other values are not
432 (currently) allowed.
3259cda First cut of Parrot_api_set_stdhandles API function
Mariano Wahlmann authored
433
434 =cut
435
436 */
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
437
3259cda First cut of Parrot_api_set_stdhandles API function
Mariano Wahlmann authored
438
439 PARROT_API
e98ef02 @Whiteknight lots of fixes. We still don't build completely, but we are much closer t...
Whiteknight authored
440 Parrot_Int
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
441 Parrot_api_set_stdhandle(Parrot_PMC interp_pmc, Parrot_PMC handle,
442 Parrot_Int fileno, ARGOUT(Parrot_PMC *old_handle))
3259cda First cut of Parrot_api_set_stdhandles API function
Mariano Wahlmann authored
443 {
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
444 ASSERT_ARGS(Parrot_api_set_stdhandle)
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
445 EMBED_API_CALLIN(interp_pmc, interp)
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
446
447 switch (fileno) {
448 case PIO_STDIN_FILENO:
449 case PIO_STDOUT_FILENO:
450 case PIO_STDERR_FILENO:
451 *old_handle = Parrot_io_stdhandle(interp, fileno, handle);
452 break;
453 default:
454 Parrot_ex_throw_from_c_args(interp, NULL, EXCEPTION_INVALID_OPERATION,
455 "Cannot set new handle %d. Must be one of 0, 1 or 2", fileno);
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
456 }
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
457
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
458 EMBED_API_CALLOUT(interp_pmc, interp)
f7fec05 @Whiteknight Add a new Parrot_api_set_stdhandle routine to the embedding API to set a...
Whiteknight authored
459 }
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
460
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
461 /*
462
463 =item C<Parrot_Int Parrot_api_get_runtime_path(Parrot_PMC interp_pmc,
464 Parrot_String *runtime)>
465
466 Stores in C<runtime> the C<interp_pmc>'s running path. This function returns a
467 true value if this call is successful and false value otherwise.
468
469 =cut
470
471 */
472
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
473 PARROT_API
474 Parrot_Int
1216a51 @Whiteknight quick initial pass for codestd
Whiteknight authored
475 Parrot_api_get_runtime_path(Parrot_PMC interp_pmc,
476 ARGOUT(Parrot_String *runtime))
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
477 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
478 ASSERT_ARGS(Parrot_api_get_runtime_path)
e9934d7 Made it compile with gcc
Mariano Wahlmann authored
479 EMBED_API_CALLIN(interp_pmc, interp)
f41cf98 @Whiteknight many more fixes. We build main.c now but fail in some of the alternate f...
Whiteknight authored
480 *runtime = Parrot_get_runtime_path(interp);
481 EMBED_API_CALLOUT(interp_pmc, interp);
482 }
483
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
484 /*
485
486 =item C<Parrot_Int Parrot_api_set_configuration_hash(Parrot_PMC interp_pmc,
487 Parrot_PMC confighash)>
488
489 Sets the C<interp_pmc>'s configuration hash passed in C<confighash>. This
490 function returns a true value if this call is successful and false value
491 otherwise.
492
493 =cut
494
495 */
496
c4ccd13 @Whiteknight first prototype of a new mechanism for setting the configuration hash as...
Whiteknight authored
497 PARROT_API
498 Parrot_Int
499 Parrot_api_set_configuration_hash(Parrot_PMC interp_pmc, Parrot_PMC confighash)
500 {
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
501 ASSERT_ARGS(Parrot_api_set_configuration_hash)
e9934d7 Made it compile with gcc
Mariano Wahlmann authored
502 EMBED_API_CALLIN(interp_pmc, interp)
c4ccd13 @Whiteknight first prototype of a new mechanism for setting the configuration hash as...
Whiteknight authored
503 Parrot_set_config_hash_pmc(interp, confighash);
5c2c3d4 @Whiteknight fix library paths. The build now progresses through all the parts that r...
Whiteknight authored
504 Parrot_lib_update_paths_from_config_hash(interp);
c4ccd13 @Whiteknight first prototype of a new mechanism for setting the configuration hash as...
Whiteknight authored
505 EMBED_API_CALLOUT(interp_pmc, interp);
506 }
507
e1ced3e @Whiteknight add a note explaining this stupid function
Whiteknight authored
508 /*
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
509
f0bd1e1 First cut of load_language, set_compiler, get compiler
Mariano Wahlmann authored
510 =item C<Parrot_Int Parrot_api_load_language(Parrot_PMC interp_pmc, Parrot_String
d74cf45 @Whiteknight fix build warnings in src/embed/api.c
Whiteknight authored
511 lang)>
3562b6b Unfished work implemented API functions
Mariano Wahlmann authored
512
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
513 Loads the HLL compiler libraries for C<lang> into the C<interp_pmc>. This
514 function returns a true value if this call is successful and false value
515 otherwise.
3562b6b Unfished work implemented API functions
Mariano Wahlmann authored
516
517 =cut
518
519 */
520
521 PARROT_API
522 Parrot_Int
c9c5a00 @leto Decorate some embed api functions and rerun headerizer
leto authored
523 Parrot_api_load_language(Parrot_PMC interp_pmc, ARGIN(Parrot_String lang))
3562b6b Unfished work implemented API functions
Mariano Wahlmann authored
524 {
525 ASSERT_ARGS(Parrot_api_load_language)
526 EMBED_API_CALLIN(interp_pmc, interp)
d74cf45 @Whiteknight fix build warnings in src/embed/api.c
Whiteknight authored
527 Parrot_load_language(interp, lang);
528 EMBED_API_CALLOUT(interp_pmc, interp);
3562b6b Unfished work implemented API functions
Mariano Wahlmann authored
529 }
530
531 /*
532
f0bd1e1 First cut of load_language, set_compiler, get compiler
Mariano Wahlmann authored
533 =item C<Parrot_Int Parrot_api_get_compiler(Parrot_PMC interp_pmc, Parrot_String
d74cf45 @Whiteknight fix build warnings in src/embed/api.c
Whiteknight authored
534 type, Parrot_PMC *compiler)>
3562b6b Unfished work implemented API functions
Mariano Wahlmann authored
535
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
536 Gets the compiler PMC and stores it in C<compiler>. This function returns a true
537 value if this call is successful and false value otherwise.
538
3562b6b Unfished work implemented API functions
Mariano Wahlmann authored
539 =cut
540
541 */
542
543 PARROT_API
544 Parrot_Int
c9c5a00 @leto Decorate some embed api functions and rerun headerizer
leto authored
545 Parrot_api_get_compiler(Parrot_PMC interp_pmc, ARGIN(Parrot_String type),
d74cf45 @Whiteknight fix build warnings in src/embed/api.c
Whiteknight authored
546 ARGOUT(Parrot_PMC *compiler))
3562b6b Unfished work implemented API functions
Mariano Wahlmann authored
547 {
548 ASSERT_ARGS(Parrot_api_get_compiler)
549 EMBED_API_CALLIN(interp_pmc, interp)
86353cc @bilalakhtar More function renames, now stuck at PIR files
bilalakhtar authored
550 *compiler = Parrot_interp_get_compiler(interp, type);
d74cf45 @Whiteknight fix build warnings in src/embed/api.c
Whiteknight authored
551 EMBED_API_CALLOUT(interp_pmc, interp);
f0bd1e1 First cut of load_language, set_compiler, get compiler
Mariano Wahlmann authored
552 }
553
554 /*
555
556 =item C<Parrot_Int Parrot_api_set_compiler(Parrot_PMC interp_pmc, Parrot_String
d74cf45 @Whiteknight fix build warnings in src/embed/api.c
Whiteknight authored
557 type, Parrot_PMC compiler)>
f0bd1e1 First cut of load_language, set_compiler, get compiler
Mariano Wahlmann authored
558
cc0610a @bluescreen10 Fixed codigstd tests
bluescreen10 authored
559 Sets the C<compiler> object for the C<type> files. This function returns a true
560 value if this call is successful and false value otherwise.
561
f0bd1e1 First cut of load_language, set_compiler, get compiler
Mariano Wahlmann authored
562 =cut
563
564 */
565
566 PARROT_API
567 Parrot_Int
c9c5a00 @leto Decorate some embed api functions and rerun headerizer
leto authored
568 Parrot_api_set_compiler(Parrot_PMC interp_pmc, ARGIN(Parrot_String type),
569 ARGIN(Parrot_PMC compiler))
f0bd1e1 First cut of load_language, set_compiler, get compiler
Mariano Wahlmann authored
570 {
571 ASSERT_ARGS(Parrot_api_set_compiler)
572 EMBED_API_CALLIN(interp_pmc, interp)
e85966a @bilalakhtar Rename functions yet again...
bilalakhtar authored
573 Parrot_interp_set_compiler(interp, type, compiler);
255a8d8 @Whiteknight move -G commandline argument parsing from IMCC into the frontend
Whiteknight authored
574 EMBED_API_CALLOUT(interp_pmc, interp)
3562b6b Unfished work implemented API functions
Mariano Wahlmann authored
575 }
0814f94 Merged changes with branch
Mariano Wahlmann authored
576
255a8d8 @Whiteknight move -G commandline argument parsing from IMCC into the frontend
Whiteknight authored
577 /*
578
579 =item C<Parrot_Int Parrot_api_toggle_gc(Parrot_PMC interp_pmc, Parrot_Int on)>
580
581 Turn Parrot's GC on or off.
582
583 =cut
584
585 */
586
587 PARROT_API
588 Parrot_Int
589 Parrot_api_toggle_gc(Parrot_PMC interp_pmc, Parrot_Int on)
590 {
591 ASSERT_ARGS(Parrot_api_toggle_gc)
592 EMBED_API_CALLIN(interp_pmc, interp)
593 if (on) {
594 Parrot_unblock_GC_mark(interp);
595 Parrot_unblock_GC_sweep(interp);
596 }
597 else {
598 Parrot_block_GC_mark(interp);
599 Parrot_block_GC_sweep(interp);
600 }
601 EMBED_API_CALLOUT(interp_pmc, interp)
602 }
6f90f7d @nol888 Add API functions to get a class from an array, and to instantiate a PMC...
nol888 authored
603
c6fa8b7 @mikehh fix codetest failures - add c function docs and ASSERT_ARGS
mikehh authored
604 /*
605
606 =item C<Parrot_Int Parrot_api_reset_call_signature(Parrot_PMC interp_pmc,
607 Parrot_PMC ctx)>
608
609 Reset the call signature
610
611 =cut
612
613 */
614
f0c28dc @Whiteknight Add in an API function so that we can reset and reuse an existing CallCo...
Whiteknight authored
615 PARROT_API
616 Parrot_Int
c9c5a00 @leto Decorate some embed api functions and rerun headerizer
leto authored
617 Parrot_api_reset_call_signature(Parrot_PMC interp_pmc, ARGMOD(Parrot_PMC ctx))
f0c28dc @Whiteknight Add in an API function so that we can reset and reuse an existing CallCo...
Whiteknight authored
618 {
c6fa8b7 @mikehh fix codetest failures - add c function docs and ASSERT_ARGS
mikehh authored
619 ASSERT_ARGS(Parrot_api_reset_call_signature)
f0c28dc @Whiteknight Add in an API function so that we can reset and reuse an existing CallCo...
Whiteknight authored
620 EMBED_API_CALLIN(interp_pmc, interp)
621 STRING * const callcontext = Parrot_str_new(interp, "CallContext", 0);
622 if (!VTABLE_isa(interp, ctx, callcontext))
623 Parrot_ex_throw_from_c_args(interp, NULL, EXCEPTION_INVALID_OPERATION,
624 "Not a valid CallContext");
625 VTABLE_morph(interp, ctx, PMCNULL);
626 EMBED_API_CALLOUT(interp_pmc, interp)
627 }
628
0814f94 Merged changes with branch
Mariano Wahlmann authored
629 /*
630
027abfa @Whiteknight add two new API functions for dealing with opaque user data pointers
Whiteknight authored
631 =item C<Parrot_Int Parrot_api_wrap_pointer(Parrot_PMC interp_pmc, void *ptr,
632 Parrot_Int size, Parrot_PMC *pmc)>
633
634 Wrap a user data pointer into a Ptr PMC for passing into Parrot. This PMC
635 is designed such that Parrot will treat the pointer as being opaque and will
636 not attempt to dereference, examine, or manipulate it at all.
637
638 Optionally a C<size> parameter can be passed. If C<size> is greater than zero,
639 the size information will be included with the pointer for later use. If
640 C<size> is less than or equal to zero, it will be ignored and will not be
641 included in the PMC object.
642
54d5026 @plobsing [codetest] correct format of C function doc =item
plobsing authored
643 =item C<Parrot_Int Parrot_api_unwrap_pointer(Parrot_PMC interp_pmc, Parrot_PMC
644 pmc, void ** ptr, Parrot_Int * size)>
027abfa @Whiteknight add two new API functions for dealing with opaque user data pointers
Whiteknight authored
645
646 Return a pointer from a PMC. This is typically used in conjunction with
647 C<Parrot_api_wrap_pointer> to return the original wrapped pointer value from
648 the PMC. Used with other PMC types besides C<Ptr> or C<PtrBuf> will have
649 undefined results, and should not be used or relied upon.
650
651 If the pointer was stored with size information, C<size> will contain that
652 size value. Otherwise, C<size> will be -1.
653
654 Notice that this function does not destroy or alter the data PMC.
655
656 =cut
657
658 */
659
660 PARROT_API
661 Parrot_Int
662 Parrot_api_wrap_pointer(Parrot_PMC interp_pmc, ARGIN_NULLOK(void *ptr),
663 Parrot_Int size, ARGOUT(Parrot_PMC *pmc))
664 {
665 ASSERT_ARGS(Parrot_api_wrap_pointer)
666 EMBED_API_CALLIN(interp_pmc, interp)
667 PMC * ptr_pmc = NULL;
668 if (size > 0) {
669 ptr_pmc = Parrot_pmc_new(interp, enum_class_PtrBuf);
b65a8ba @bacek Fix braino in api_wrap/unwrap_pointer.
bacek authored
670 VTABLE_set_integer_native(interp, ptr_pmc, size);
edc686b @plobsing cuddled else
plobsing authored
671 }
672 else
027abfa @Whiteknight add two new API functions for dealing with opaque user data pointers
Whiteknight authored
673 ptr_pmc = Parrot_pmc_new(interp, enum_class_Ptr);
b65a8ba @bacek Fix braino in api_wrap/unwrap_pointer.
bacek authored
674 VTABLE_set_pointer(interp, ptr_pmc, ptr);
027abfa @Whiteknight add two new API functions for dealing with opaque user data pointers
Whiteknight authored
675 *pmc = ptr_pmc;
676 EMBED_API_CALLOUT(interp_pmc, interp)
677 }
678
679 PARROT_API
680 Parrot_Int
681 Parrot_api_unwrap_pointer(Parrot_PMC interp_pmc, Parrot_PMC pmc,
682 ARGOUT(void ** ptr), ARGOUT(Parrot_Int * size))
683 {
684 ASSERT_ARGS(Parrot_api_unwrap_pointer)
685 EMBED_API_CALLIN(interp_pmc, interp)
686 *ptr = VTABLE_get_pointer(interp, pmc);
687 if (pmc->vtable->base_type == enum_class_PtrBuf)
688 *size = VTABLE_get_integer(interp, pmc);
689 else
690 *size = -1;
691 EMBED_API_CALLOUT(interp_pmc, interp);
692 }
693
694 /*
695
1311cec @jkeenan [codingstd] Fix files so they pass c_operator, c_parens, pod_syntax, and
jkeenan authored
696 =back
697
9703ef5 @jkeenan [codingstd] C-style coda needed. No cuddled elses.
jkeenan authored
698 =cut
0814f94 Merged changes with branch
Mariano Wahlmann authored
699
7db7331 @jkeenan Correct C-comment syntax error.
jkeenan authored
700 */
9703ef5 @jkeenan [codingstd] C-style coda needed. No cuddled elses.
jkeenan authored
701
540a832 @jkeenan [codingstd] Mostly linelength fixes.
jkeenan authored
702 /*
703 * Local variables:
704 * c-file-style: "parrot"
705 * End:
706 * vim: expandtab shiftwidth=4 cinoptions='\:2=2' :
707 */
0814f94 Merged changes with branch
Mariano Wahlmann authored
708
Something went wrong with that request. Please try again.