<< libpointer datatype

Dynamic link

dlclose >>

---

dlcall

---

C or Fortran Foreign function call.

---

Syntax

---

[x1, ... , xN] = dlcall(dlsym_handle, arg1, ..., argN)

Input argument

---

dlsym_handle

a dlsym handle.

arg1, ..., argN

input arguments.

Output argument

---

[x1, ... , xN]

output values.

Description

---

dlcall calls an external C or Fortran function loaded from an shared library.

dlcall validates input argument types before calling based on dlsym handle definition.

Examples

---

lib = dlopen([modulepath('nelson', 'builtin'), '/libnlsDynamic_link', getdynlibext()]);
V = double([1 2;3 4]);
% C prototype:
% int dynlibTestMultiplyDoubleArrayWithReturn(double *x, int size)
f = dlsym(lib, 'dynlibTestMultiplyDoubleArrayWithReturn', 'int32', {'doublePtr', 'int32'});
[r1, r2] = dlcall(f, V, int32(numel(V)))
delete(f);
delete(lib);

Call C getpid function

run([modulepath('dynamic_link'), '/examples/call_c.m']);

Call fortran DASUM (blas) function

run([modulepath('dynamic_link'), '/examples/call_fortran.m']);

See also

---

dlsym, C/Nelson equivalent data types.

History

---

Version	Description
1.0.0	initial version

Author

---

Allan CORNET