API reference for Julia Embedding in C



Is there any official API reference for Julia Embedding in C, or should we be understanding by going through the code or asking here?
And specifically,

  • How to create and access the data in the tuple?
  • How to convert a pointer to an array(not 1D) without copying i.e. how to use ‘jl_ptr_to_array’
  • What should I pass the ‘dims’ argument? Should it be a tuple or svec or 1D array?

Thank you.


Same as other struct. Declare the right C struct and cast the pointer, or compute the offset manually, or use the getfield function.



Like? I need an example. Suppose you need to create (3, 2) Integer Tuple for the ‘dims’ argument of ‘jl_ptr_to_array’. I’m very new here.
Thank you.

jl_value_t *types[] = {(jl_value_t*)jl_long_type, (jl_value_t*)jl_long_type};
jl_tupletype_t *tt = jl_apply_tuple_type_v(types, 2);
typedef struct {
    ssize_t a;
    ssize_t b;
} ntuple2int;
ntuple2int *tuple = (ntuple2int*)jl_new_struct_uninit(tt);
tuple->a = 3;
tuple->b = 2;
jl_array_t *ary = jl_ptr_to_array(atype, data, (jl_value_t*)tuple, own_buffer);
return ary;


Thank you so much.


Btw, what about the other question that,
Documentation about Embedding Julia more than what’s there at Embedding Julia?

Thank you.


In general, the recommended approach is to use the ones described in the doc to evaluate julia code and define your own API. There are other direct runtime interfaces available although those breaks much more often and are not really well documented other than the header itself.


I’m now unable to create n length tuple.

typedef struct { ssize_t a[2]; } ntuple2int;
where 2 can be any number.
I tried this but this didn’t work.

How to create a ‘n’ length tuple then?

Thank you


So assume you don’t have any problem creating the type (unless you have a too big type you can just create a big enough buffer to pass in the tuple element types). With that you shouldn’t have any problem allocating the object either so I assume you only have problem with accessing elements.

C does not allow unknown type during compile time so you cannot declare the corresponding C type unless you know it at C code compile time in general. In this particular case though, the three methods I mentioned in the first post still all apply.

  1. You can use the getfield function. It’s accessible in C as jl_get_field. It should be pretty obvious to use. This does not need to rely on any C functions in your code, all offset calculation is down in julia runtime, it’s also the slowest.
  2. You can do offset computation yourself. You can easily predict the layout of the object with n fields. You can just do the offset computation and loads yourself. For NTuple it’s simple enough that you can just cast the pointer to ssize_t* and index it.
  3. It turns out that this is a very special case where it is actually possible to declare a compatible C struct. This require C99 and you can do it as typedef struct { ssize_t a[]; } ntupleint;


Thanks for the answer. I was able to create an NTuple and populate it.