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