table.subsasgn — Assign through a table or timetable subscript path.
table.subsasgn(T,S,rhs) returns an updated table or timetable. Dot assignment sets a variable or Properties; parentheses assign table rows and variables; braces assign selected variable contents.
Syntax
T = table.subsasgn(T, 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 value carries the assignment. Callers must use the returned object; the original value is not mutated in place.
Variable row counts and selected dimensions are checked before insertion. Chained paths assign into the selected child and write the updated child back into the outer table.
Typed integer variables retain their class when the assignment is admissible. Static analysis preserves the receiver's table or timetable identity but invalidates its previous schema facts.
Execution and placement
Assignment is a host-side object operation and a numeric fusion boundary. A selected nested value may have its own residency and indexing behavior.
A chained assignment may suspend or throw. The runtime does not replay effects after a failed nested assignment.
Example
Replace a typed variable
T = table(uint64([1; 2]), 'VariableNames', {'Count'}); S = struct('type', '.', 'subs', 'Count'); T = subsasgn(T,S,uint64([3; 4]));Using table.subsasgn with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how table.subsasgn changes the result.
Run a small table.subsasgn example, explain the result, then change one input and compare the output.
FAQ
Does subsasgn mutate its input?⌄
No. Assign the returned table to a variable to keep the change.
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 table.subsasgn is executed, line by line, in Rust.
- View the source for table.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.