# Documentation

### This is machine translation

Translated by
Mouse over text to see original. Click the button below to return to the English verison of the page.

# table2array

Convert table to homogeneous array

## Syntax

• ``A = table2array(T)``
example

## Description

example

````A = table2array(T)` converts the table, `T`, to a homogeneous array, `A`. ```

## Examples

collapse all

Create a table, `T`, consisting of numeric data.

```T = table([1;2;3],[2 8; 4 10; 6 12],[3 12 21; 6 15 24; 9 18 27],... 'VariableNames',{'One' 'Two' 'Three'}) ```
```T = One Two Three ___ _______ _____________ 1 2 8 3 12 21 2 4 10 6 15 24 3 6 12 9 18 27 ```

Convert table, `T`, to an array.

```A = table2array(T) ```
```A = 1 2 8 3 12 21 2 4 10 6 15 24 3 6 12 9 18 27 ```

`A` contains two columns from variable `Two` and three columns from variable `Three`.

Define the numeric subset of a table to convert to an array.

Create a table with nonnumeric data in the first variable.

```T = table(categorical({'M';'M';'F';'F';'F'}),[38;43;38;40;49],... [71;69;64;67;64],[176;163;131;133;119],... 'VariableNames',{'Gender' 'Age' 'Height' 'Weight'}) ```
```T = Gender Age Height Weight ______ ___ ______ ______ M 38 71 176 M 43 69 163 F 38 64 131 F 40 67 133 F 49 64 119 ```

Convert `T(:,2:4)` to an array.

```A = table2array(T(:,2:4)) ```
```A = 38 71 176 43 69 163 38 64 131 40 67 133 49 64 119 ```

`A` does not include data from the variable `Gender`.

Create a table, `T`, with two rows and three variables where each variable has three dimensions.

```T = table(ones(2,1,3),2*ones(2,2,3),3*ones(2,3,3),... 'VariableNames',{'One' 'Two' 'Three'}) ```
```T = One Two Three ______________ ______________ ______________ [1x1x3 double] [1x2x3 double] [1x3x3 double] [1x1x3 double] [1x2x3 double] [1x3x3 double] ```

The size of the table is 2-by-3.

Convert table `T` to an array.

```A = table2array(T) ```
```A(:,:,1) = 1 2 2 3 3 3 1 2 2 3 3 3 A(:,:,2) = 1 2 2 3 3 3 1 2 2 3 3 3 A(:,:,3) = 1 2 2 3 3 3 1 2 2 3 3 3 ```

The size of `A` is 2-by-6-by-3.

## Input Arguments

collapse all

Input table, specified as a table. All variables in `T` must have sizes and data types that are compatible for horizontal concatenation. Specifically, the size of all variable dimensions greater than `2` must match.

• If `T` is an `m`-by`n` table with variables that each have one column, then each variable becomes one column in `A`, and `A` is an `m`-by-`n` array.

• If `T` contains variables that consist of more than one column, those variables become multiple columns in `A`, and the size of `A` is greater than the size of `T`.

• If `T` contains variables with more than two dimensions, the number of dimensions of `A` is the same as the number of variable dimensions.

collapse all

### Tall Array Support

This function fully supports tall arrays. For more information, see Tall Arrays.

### Tips

• `table2array` horizontally concatenates the variables in `T` to create `A`. If the variables in `T` are cell arrays, `table2array` does not concatenate their contents, and `A` is a cell array, equivalent to `table2cell(T)`. To create an array containing the contents of variables that are all cell arrays, use `cell2mat(table2cell(T))`.

• `table2array(T)` is equivalent to `T{:,:}`.

### Algorithms

If `T` contains variables with different data types that are compatible for horizontal concatenation, `table2array` creates a homogeneous array, `A`, of the dominant data type. For example, if `T` contains `double` and `single` numeric data, `table2array(T)` returns an array with data type `single`.