table2cell

Convert table to cell array

Syntax

C = table2cell(T)

Description

C = table2cell(T) converts the table, T, to a cell array, C. Each variable in T becomes a column of cells in C.

Examples

Convert Table to Cell Array

Create a table, T, with five rows and three variables.

T = table(categorical({'M';'M';'F';'F';'F'}),[38;43;38;40;49],...
    [124 93;109 77; 125 83; 117 75; 122 80],...
    'VariableNames',{'Gender' 'Age' 'BloodPressure'},...
    'RowNames',{'Smith' 'Johnson' 'Williams' 'Jones' 'Brown'})

T=5×3 table
                Gender    Age    BloodPressure
                ______    ___    _____________

    Smith         M       38      124     93  
    Johnson       M       43      109     77  
    Williams      F       38      125     83  
    Jones         F       40      117     75  
    Brown         F       49      122     80  

Convert T to a cell array.

C = table2cell(T)

C=5×3 cell array
    {[M]}    {[38]}    {[124 93]}
    {[M]}    {[43]}    {[109 77]}
    {[F]}    {[38]}    {[125 83]}
    {[F]}    {[40]}    {[117 75]}
    {[F]}    {[49]}    {[122 80]}

C is a 5-by-3 cell array.

Vertically concatenate the table property, T.Properties.VariableNames, with C to include column headings for the cell array.

[T.Properties.VariableNames;C]

ans=6×3 cell array
    {'Gender'}    {'Age'}    {'BloodPressure'}
    {[M     ]}    {[ 38]}    {[       124 93]}
    {[M     ]}    {[ 43]}    {[       109 77]}
    {[F     ]}    {[ 38]}    {[       125 83]}
    {[F     ]}    {[ 40]}    {[       117 75]}
    {[F     ]}    {[ 49]}    {[       122 80]}

T.Properties.VariableNames is a cell array of character vectors.

Input Arguments

T — Input table

table

Input table, specified as a table.

If T is an m-byn table, then C is an m-by-n cell array.

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

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

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

This function fully supports code generation. For more information, see Code Generation for Tables (MATLAB Coder).

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).