This calls into GCC and builds the code, returning a gcc_jit_result *.
If the result is non-NULL, the caller becomes responsible for calling gcc_jit_result_release() on it once they’re done with it.
A gcc_jit_result encapsulates the result of compiling a context in-memory, and the lifetimes of any machine code functions or globals that are within the result.
Locate a given function within the built machine code.
Functions are looked up by name. For this to succeed, a function with a name matching funcname must have been created on result’s context (or a parent context) via a call to gcc_jit_context_new_function() with kind GCC_JIT_FUNCTION_EXPORTED:
gcc_jit_context_new_function (ctxt,
any_location, /* or NULL */
/* Required for func to be visible to
gcc_jit_result_get_code: */
GCC_JIT_FUNCTION_EXPORTED,
any_return_type,
/* Must string-compare equal: */
funcname,
/* etc */);
If such a function is not found (or result or funcname are
NULL), an error message will be emitted on stderr and
NULL will be returned.
If the function is found, the result will need to be cast to a function pointer of the correct type before it can be called.
Note that the resulting machine code becomes invalid after gcc_jit_result_release() is called on the gcc_jit_result *; attempting to call it after that may lead to a segmentation fault.
Locate a given global within the built machine code.
Globals are looked up by name. For this to succeed, a global with a name matching name must have been created on result’s context (or a parent context) via a call to gcc_jit_context_new_global() with kind GCC_JIT_GLOBAL_EXPORTED.
If the global is found, the result will need to be cast to a pointer of the correct type before it can be called.
This is a `pointer' to the global, so e.g. for an int this is
an int *.
For example, given an int foo; created this way:
gcc_jit_lvalue *exported_global = gcc_jit_context_new_global (ctxt, any_location, /* or NULL */ GCC_JIT_GLOBAL_EXPORTED, int_type, "foo");
we can access it like this:
int *ptr_to_foo = (int *)gcc_jit_result_get_global (result, "foo");
If such a global is not found (or result or name are
NULL), an error message will be emitted on stderr and
NULL will be returned.
Note that the resulting address becomes invalid after gcc_jit_result_release() is called on the gcc_jit_result *; attempting to use it after that may lead to a segmentation fault.
Once we’re done with the code, this unloads the built .so file. This cleans up the result; after calling this, it’s no longer valid to use the result, or any code or globals that were obtained by calling gcc_jit_result_get_code() or gcc_jit_result_get_global() on it.