主要内容

array2table

将同构数组转换为表

说明

T = array2table(A)m×n 数组转换为 m×n 表。输入 A 的每列都成为输出 T 中的一个变量。

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

示例

T = array2table(A,Name=Value) 可在前面语法中的输入参量外使用一个或多个名称-值参量来指定选项。例如,您可以通过将 VariableNames 设置为变量名称的字符串数组来指定变量名称。

示例

示例

全部折叠

创建一个数值数组。

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 = [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

将该数组转换为一个具有指定变量名称的表。

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 是对应的值。名称-值参量必须出现在其他参量之后,但对各个参量对组的顺序没有要求。

示例: RowNames=["row1" "row2" "row3"] 为一个具有三行的表指定行名称 row1row2row3

行名称,指定为字符串数组或字符向量元胞数组,其元素为非空且各不相同。行名称的数量必须等于输入数组的行数。

行名称可以包含任何 Unicode® 字符,包括空格和非 ASCII 字符,但冒号字符 : 除外。

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

变量名称,指定为字符串数组或字符向量元胞数组,其元素为非空且各不相同。变量名称的数量必须等于输入数组的列数。

变量名称可以包含任何 Unicode 字符,包括空格和非 ASCII 字符。但是,变量名称不能与任何表维度名称或保留名称 PropertiesRowNamesVariableNames 或冒号字符 : 匹配。

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

维度名称可以包含任何 Unicode 字符,包括空格和非 ASCII 字符。但是,维度名称不能与任何表变量名称或保留名称 PropertiesRowNamesVariableNames 或冒号字符 : 匹配。

或者,在所有版本中,您可以通过设置表的 DimensionNames 属性来指定维度名称。

输出参量

全部折叠

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

提示

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

扩展功能

全部展开

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

版本历史记录

在 R2013b 中推出

全部展开