table2array — Convert table variables into a homogeneous array when possible.
table2array(T) horizontally concatenates compatible table variables into one homogeneous array. Table row names, timetable row times, and other table properties are not included.
Syntax
A = table2array(T)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
T | Any | Yes | — | Input table or timetable. |
Returns
| Name | Type | Description |
|---|---|---|
B | Any | Converted output value. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:table:InvalidArgument | Arguments or table metadata are invalid. | table: invalid argument |
RunMat:table:InvalidIndex | Table indexing is invalid. | table: invalid index |
RunMat:table:InvalidVariable | A table variable name or value is invalid. | table: invalid variable |
How table2array works
- Same-class integer variables concatenate without conversion, preserving exact signedness, width, and values above
flintmax. - Compatible mixed numeric variables use the table-concatenation dominant class and its assignment conversion rules. A native single variable makes an otherwise floating result single.
- If all variables are cell arrays, the result is a cell array equivalent to
table2cell(T). Broader heterogeneous concatenation remains limited by the currently implemented table indexing surface.
Examples
Converting Numeric Variables To A Matrix
A = table2array(array2table([1 3; 2 4]))Expected output:
A = [1 3; 2 4]Preserving Wide Integer Values
T = table(uint64([9007199254740993; 9007199254740995]));
A = table2array(T)Expected output:
A = 2x1 uint64 column with the same exact valuesUsing table2array with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how table2array changes the result.
Run a small table2array example, explain the result, then change one input and compare the output.
Related Table functions
array2table · array2timetable · categorical · cell2table · dictionary · groupsummary · head · height · iscategorical · isordinal · istable · istimetable · ordinal · pivot · rowfilter · struct2table · table · table2cell · table2struct · table2timetable · timerange · timetable · timetable2table · uitable · vartype · width
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how table2array is executed, line by line, in Rust.
- View the source for table2array in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 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.