calllib — Call a declared function in a loaded native C library.
calllib(alias, function, arguments...) resolves the public C function name through the exact prepared interface manifest, converts arguments according to its declared ABI types, and returns the native result followed by declared output parameters. Requested output count is checked against the declaration.
Syntax
[outputs] = calllib(alias, function, arguments...)Inputs
alias- Type
Any- Required
- Yes
- Default
- —
- Description
- Scalar text, number, or logical loaded library alias.
function- Type
Any- Required
- Yes
- Default
- —
- Description
- Scalar text, number, or logical declared C symbol name.
arguments- Type
Any- Required
- Variadic
- Default
- —
- Description
- Native ABI values interpreted by the prepared function signature, including exact integer arrays and foreign handles.
Returns
outputs- Type
Any- Description
- Return value and output parameters determined by the prepared function signature.
Returned values from calllib depend on how many outputs the caller requests.
Errors
RunMat:Foreign:UnsupportedOnWasm- When
- The current host cannot load a native shared library.
- Message
Native shared libraries are unavailable on this host.
RunMat:Foreign:InvalidCall- When
- Arguments do not satisfy the normalized shared-library contract.
- Message
Invalid shared-library operation.
RunMat:Foreign:HostUnavailable- When
- A native shared-library operation is invoked without an active runtime context.
- Message
Native shared-library operation has no active runtime context.
Values and ownership
Exact fixed-width integer storage is preserved at the ABI boundary. Pointer and structure values retain adapter-owned handle metadata; a borrowed pointer returned by C is not copied into caller-owned memory. Native callbacks and output parameters follow the prepared function signature.
Isolation
In-process calls execute on the native session lane; an explicitly isolated adapter runs the same manifest contract in its process. A browser does not execute this native call and reports an unsupported-host error.
Example
Call a declared integer function
loadlibrary('fixture', 'fixture.h', 'Alias', 'fixture');
answer = calllib('fixture', 'fixture_add', int32(2), int32(3));
assert(answer == int32(5));
unloadlibrary('fixture');Using calllib with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how calllib changes the result.
Run a small calllib example, explain the result, then change one input and compare the output.
FAQ
Can I call an exported symbol absent from the header?⌄
No. The function must be declared in the prepared interface manifest, even if the library exports its name.
Related Interop functions
Native
clibgen.buildInterface · libfunctions · libisloaded · libpointer · libstruct · loadlibrary · setdatatype · unloadlibrary
Java
isjava · javaaddpath · javaArray · javaclasspath · javaMethod · javaMethodEDT · javaObject · javaObjectEDT · javarmpath · jenv · usejava
Source you can read
Every RunMat function's source is public. Read exactly how calllib is executed, line by line, in Rust.
- View the source for calllib in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.