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.
Returns
obj- Type
Any- Description
- Updated 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
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
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.