evalin — Evaluate source text in a selected workspace.
evalin selects the base or caller workspace and evaluates scalar source text there. Output facts and side effects depend on that source.
Syntax
[varargout] = evalin(workspace, source)Inputs
workspace- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- `base` or `caller` workspace selector.
source- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Source text to evaluate in the selected workspace.
Returns
varargout- Type
Any- Description
- Value(s) produced by evaluated source text.
Returned values from evalin depend on how many outputs the caller requests.
Errors
RunMat:DynamicWorkspaceRequiresVm- When
- A dynamic workspace builtin is dispatched without an active workspace execution context.
- Message
dynamic workspace builtin requires an active workspace execution context
Behavior
The workspace selector is scalar text. evalin may read or modify bindings in the selected workspace; it does not prove that a dynamically named binding exists.
An active workspace execution service is required. The selected source determines output count, class, shape, and further effects.
Example
Read a base-workspace expression
base_value = 7; selected = evalin('base', 'base_value + 1');Expected output:
selected = 8Using evalin with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how evalin changes the result.
Run a small evalin example, explain the result, then change one input and compare the output.
Related Introspection functions
addlistener · addParameter · addprop · assignin · builtin · cancel · class · clear · clearAllMemoizedCaches · clearCache · clearvars · dbclear · dbstack · dbstatus · dbtype · eval · evalc · feval · findprop · func2str · functions · get.p · getcallinfo · getmethod · inputname · inputParser · isa · ischar · isdeployed · iskeyword · ismethod · isobject · isstring · isUnderlyingType · isvalid · keyboard · loadobj · localfunctions · matlab.metadata.DynamicProperty.delete · memoize · metaclass · mfilename · mislocked · mlock · munlock · namelengthmax · narginchk · nargoutchk · new_object · notify · numArgumentsFromSubscript · onCleanup · parse · saveobj · set.p · stats · str2func · subsasgn · subsref · superclasses · underlyingType · verLessThan · version · which · who · whos
Source you can read
Every RunMat function's source is public. Read exactly how evalin is executed, line by line, in Rust.
- View the source for evalin 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.