javaclasspath — Inspect or replace the session's Java classpath.
paths = javaclasspath() returns the dynamic paths. '-dynamic', '-static', and '-all' select the returned layer. Path arguments replace the dynamic path; '-v0' and '-v1' are accepted compatibility forms with no result.
Syntax
paths = javaclasspath()
paths = javaclasspath('-dynamic' | '-static' | '-all')
javaclasspath(path, ...)Inputs
option- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Java environment or classpath option.
path- Type
Any- Required
- Yes
- Default
- —
- Description
- Session dynamic-classpath text entry or cell of text entries.
arguments- Type
Any- Required
- Variadic
- Default
- —
- Description
- Arguments converted at the Java foreign boundary.
Returns
result- Type
Any- Description
- Result converted from the session JVM.
Errors
RunMat:Foreign:UnsupportedOnWasm- When
- A JVM operation is called in a browser without a native Java host.
- Message
Java interoperability is unavailable on this host.
RunMat:Foreign:InvalidCall- When
- A Java builtin receives an invalid public argument form.
- Message
Invalid Java interoperability operation.
RunMat:Foreign:HostUnavailable- When
- A native Java call has no active runtime context.
- Message
Java operation has no active runtime context.
Queries and mutation
Query forms return a column cell array of character paths. Replacement affects the current session's dynamic class loader, while existing object handles retain their Java identity. The compatibility -v0 and -v1 forms do not return a value.
Example
Inspect dynamic paths
paths = javaclasspath('-dynamic');Using javaclasspath with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how javaclasspath changes the result.
Run a small javaclasspath example, explain the result, then change one input and compare the output.
FAQ
Which classpath does the no-argument form return?⌄
The current session's dynamic classpath. Use '-static' or '-all' for the other views.
Related Interop functions
Java
isjava · javaaddpath · javaArray · javaMethod · javaMethodEDT · javaObject · javaObjectEDT · javarmpath · jenv · usejava
Native
calllib · clibgen.buildInterface · libfunctions · libisloaded · libpointer · libstruct · loadlibrary · setdatatype · unloadlibrary
Related guides
Source you can read
Every RunMat function's source is public. Read exactly how javaclasspath is executed, line by line, in Rust.
- View the source for javaclasspath 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.