Main Content

array2table

将同构数组转换为表

说明

示例

T = array2table(A)m×n 数组 A 转换为 m×nTA 的每一列都变成 T 的变量。

array2table 为表中的变量名称使用末尾追加了列号的输入数组名称。如果这些名称不是有效的 MATLAB® 标识符,array2table 将使用 'Var1',...,'VarN' 形式的名称,其中 NA 的列数。

示例

T = array2table(A,Name,Value) 从数组 A 创建一个表,附加选项由一个或多个 Name,Value 对组参数指定。

例如,您可以指定要包含在表中的行名称或变量名称。

示例

全部折叠

创建一个数值数据数组。

A = [1 4 7; 2 5 8; 3 6 9]
A = 3×3

     1     4     7
     2     5     8
     3     6     9

将数组 A 转换为表。

T = array2table(A)
T=3×3 table
    A1    A2    A3
    __    __    __

    1     4     7 
    2     5     8 
    3     6     9 

该表的变量名称将列数添加到输入数组名 A 后。

创建一个数值数据数组。

A = [1 12 30.48; 2 24 60.96; 3 36 91.44]
A = 3×3

    1.0000   12.0000   30.4800
    2.0000   24.0000   60.9600
    3.0000   36.0000   91.4400

将数组 A 转换为表并包含变量名称。

T = array2table(A,...
    'VariableNames',{'Feet','Inches','Centimeters'})
T=3×3 table
    Feet    Inches    Centimeters
    ____    ______    ___________

     1        12         30.48   
     2        24         60.96   
     3        36         91.44   

输入参数

全部折叠

输入数组,指定为矩阵。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | cell
复数支持:

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参数名称,Value 是对应的值。名称-值参数必须出现在其他参数之后,但参数对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: 'RowNames',{'row1','row2','row3'} 将行名称 row1row2row3 用于表 T

T 的行名称,指定为以逗号分隔的对组,其中包含 'RowNames' 和一个由非空的不同元素构成的字符向量元胞数组或字符串数组。名称的数量必须等于行数 size(A,1)

行名称可以包含任何 Unicode® 字符,包括空格和非 ASCII 字符。

如果您指定的行名称包含前导或尾部空白字符,则 array2table 会将它们从行名称中删除。

T 的变量名称,指定为以逗号分隔的对组,其中包含 'VariableNames' 和一个由非空的不同元素构成的字符向量元胞数组或字符串数组。名称的数量必须等于变量数 size(A,2)

变量名称可以包含任何 Unicode 字符,包括空格和非 ASCII 字符。

自 R2021a 开始提供

维度名称,指定为二元素字符向量元胞数组或二元素字符串数组,其元素为非空且不同。

维度名称可以包含任何 Unicode 字符,包括空格和非 ASCII 字符。

在 R2021a 之前,只能通过设置输出的 DimensionNames 属性来指定维度名称。

输出参数

全部折叠

输出表,以表形式返回。该表可以存储元数据,例如描述、变量单位、变量名称和行名称。有关详细信息,请参阅 table 的“属性”部分。

提示

  • 如果 A 是一个元胞数组,使用 cell2table(A) 可根据 A 的元胞内容创建表。表中每个变量都是一个数值或一个字符向量元胞数组。array2table(A) 创建一个每个变量为一列元胞的表。

扩展功能

基于线程的环境
使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

版本历史记录

在 R2013b 中推出

全部展开