RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • dictionary.subsasgn
    • dictionary.subsref
    • table.subsasgn
    • table.subsref

dictionary.subsasgn — Insert, replace, or remove dictionary entries through an indexing path.

dictionary.subsasgn(d,S,rhs) returns an updated dictionary. Parentheses and braces assign by key; an empty right-hand value removes matching keys.

Syntax

d = dictionary.subsasgn(d, S, rhs)

Inputs

obj
Type
Any
Required
Yes
Default
—
Description
Table or dictionary value whose indexing method is invoked.
S
Type
Any
Required
Yes
Default
—
Description
Standard structure or structure-array indexing path with type and subs fields.
rhs
Type
Any
Required
Yes
Default
—
Description
Value assigned at the selected location.
NameTypeRequiredDefaultDescription
objAnyYes—Table or dictionary value whose indexing method is invoked.
SAnyYes—Standard structure or structure-array indexing path with type and subs fields.
rhsAnyYes—Value assigned at the selected location.

Returns

obj
Type
Any
Description
Updated value object; the original receiver is not mutated in place.
NameTypeDescription
objAnyUpdated value object; the original receiver is not mutated in place.

Errors

RunMat:table:InvalidArgument
When
Arguments or table metadata are invalid.
Message
table: invalid argument
RunMat:table:InvalidIndex
When
Table indexing is invalid.
Message
table: invalid index
RunMat:table:InvalidVariable
When
A table variable name or value is invalid.
Message
table: invalid variable
IdentifierWhenMessage
RunMat:table:InvalidArgumentArguments or table metadata are invalid.table: invalid argument
RunMat:table:InvalidIndexTable indexing is invalid.table: invalid index
RunMat:table:InvalidVariableA table variable name or value is invalid.table: invalid variable

Behavior

The returned dictionary carries the change; the original value is not mutated in place. A scalar right-hand value expands across several keys; non-scalar assignments must match the query shape.

New values are normalized to the existing dictionary value class. Integer key comparison retains native precision, including values above the exact-double range.

Single keys and values retain native binary32 class. Repeated inserted keys keep their first insertion position and last assigned value, including duplicates within one assignment.

Chained paths update a selected child and write it back into the outer dictionary.

Execution and placement

Dictionary assignment is host-side and a numeric fusion boundary. Nested values can have their own residency and indexing behavior.

The method may suspend or throw during nested assignment; direct distributed dictionary handles are unsupported.

Typed native edits preflight key/value conversions and shapes, admit native index scratch and retained outputs, then publish both properties atomically. The public standard-substruct adapter still rejects finite Managed execution before the shared path/component workspace is allocated.

Example

Replace an integer value

d = dictionary('a',uint64(3)); S = struct('type', '()', 'subs', {{'a'}}); d = subsasgn(d,S,uint64(9)); v = subsref(d,S);

Using dictionary.subsasgn with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how dictionary.subsasgn changes the result.

Run a small dictionary.subsasgn example, explain the result, then change one input and compare the output.

FAQ

How do I remove an entry?⌄

Assign an empty right-hand value at its key and keep the returned dictionary.

Related Table functions

Indexing

dictionary.subsref · table.subsasgn · table.subsref

Table

array2table · array2timetable · categorical · cell2table · dictionary · groupsummary · head · iscategorical · isordinal · istable · istimetable · ordinal · pivot · rowfilter · struct2table · table · table2array · table2cell · table2struct · table2timetable · timerange · timetable · timetable2table · uitable · vartype

Source you can read

Every RunMat function's source is public. Read exactly how dictionary.subsasgn is executed, line by line, in Rust.

  • View the source for dictionary.subsasgn 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.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Behavior
  • Execution and placement
  • Example
  • Replace an integer value
  • Using dictionary.subsasgn with coding agents
  • FAQ
  • Related Table functions
  • Indexing
  • Table
  • Source you can read
  • About RunMat