matlas
matlas is a Rust-native safety layer for MATLAB's API-800 Matrix, MEX, and
MAT-file interfaces. It is not a wrapper around rustmex: MATLAB-owned
arrays, Rust-owned arrays, workspace borrows, and persistent arrays are
different Rust types with different lifetimes and drop behavior.
Requirements
- MATLAB with
matrix.h,mex.h, andmat.h - Rust and a native C compiler supported by MATLAB
- MATLAB R2025a/API 800 is the current validation target
Set MATLABROOT to the MATLAB installation. The build script links the
versioned API libraries and compiles the C shim automatically.
Example
use ;
mex_entrypoint!;
OwnedArray is the unique Rust owner and destroys its mxArray on drop.
ArrayRef is read-only and cannot be destroyed or transferred. A
WorkspaceRef borrows MATLAB workspace memory through &mut Matlab, so a
callback or workspace mutation cannot occur while that pointer is live.
MatFile provides typed open/create, get, metadata, put, global put, delete,
directory listing, and explicit close. OwnedArray::persist returns a
generation-checked handle that can be kept between MEX invocations; accessing
it again requires the new invocation's Matlab context.
Status
The old rustmat and rustmex APIs are intentionally not dependencies.
Windows/R2025a is the first supported target. The R2025a/API-800 audit covers all 178 published C
functions: safe operations use lifetime-aware types, aliases use a more general
safe operation, and ownership-adopting or non-local-exit operations remain
explicitly unsafe in matlas::raw. See API_COVERAGE.md
for the function-by-function inventory, DESIGN.md for the
ownership model, ERROR_HANDLING.md for what Result
can and cannot catch, and VALIDATION.md for current checks.
License
MIT. MATLAB headers and libraries are not distributed; users must follow MathWorks licensing and deployment terms.