table.subsref — Read a table variable, a table subset, or selected variable contents.
table.subsref(T,S) applies a standard indexing path to a table or timetable. Dot indexing reads a variable or Properties; parentheses return a table subset; braces return selected contents.
Syntax
out = table.subsref(T, S)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.
Returns
out- Type
Any- Description
- The selected table, variable, dictionary value, or nested member.
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
Each element of S supplies a type ('.', '()', or '{}') and subs selector. Chained paths are processed in order through the object indexing protocol.
A selected variable retains its stored numeric class. The result of a general path depends on table schema and selector contents, so static analysis keeps its value dynamic.
Table and timetable receivers share the indexing implementation. A timetable's row-time variable can also be selected by its dimension name.
Execution and placement
Table indexing is a host-side object operation and a numeric fusion boundary. Selected variables may themselves carry resident data; reading a variable does not imply a gather.
The path can suspend or throw during nested indexing. Direct distributed table handles are not admitted by this method.
Example
Read a typed table variable
T = table(uint64([1; 2]), 'VariableNames', {'Count'}); S = struct('type', '.', 'subs', 'Count'); v = subsref(T,S);Using table.subsref with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how table.subsref changes the result.
Run a small table.subsref example, explain the result, then change one input and compare the output.
FAQ
Does table.subsref always return a table?⌄
No. Parentheses return a table, while dot and brace indexing can return a stored variable or selected contents.
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.subsref is executed, line by line, in Rust.
- View the source for table.subsref 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.