eval — Evaluate source text in the current workspace.
eval executes scalar source text in the current workspace through the active dynamic-source execution service. Its result and effects depend on that source and cannot be inferred from the text value's type alone.
Syntax
[varargout] = eval(source)Inputs
source- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Source text to evaluate in the current workspace.
Returns
varargout- Type
Any- Description
- Value(s) produced by evaluated source text.
Returned values from eval 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 source may read or modify current-workspace bindings. Requested outputs are forwarded to the evaluated expression; no output class or shape is promised by eval itself.
An active workspace execution service is required. A direct runtime builtin dispatch without one raises RunMat:DynamicWorkspaceRequiresVm.
Example
Update a current-workspace variable
current_value = 4; eval('current_value = current_value + 3;');Using eval with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how eval changes the result.
Run a small eval 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 · evalc · evalin · 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 eval is executed, line by line, in Rust.
- View the source for eval 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.