array2table

将同构数组转换为表

全页折叠

语法

T = array2table(A)
T = array2table(A,Name,Value)

说明

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

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

示例

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'} 将行名称 row1、row2 和 row3 用于表 T。

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

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

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

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

变量名称可以包含任何 Unicode 字符，包括空格和非 ASCII 字符。但是，变量名称不能与任何表维度名或保留名称 'Properties'、'RowNames'、'VariableNames' 或 ':' 匹配。

自 R2021a 起

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

维度名称可以包含任何 Unicode 字符，包括空格和非 ASCII 字符。但是，维度名称不能与任何表变量名称或保留名称 'Properties'、'RowNames'、'VariableNames' 或 ':' 匹配。

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

输出参量

全部折叠

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

提示

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

扩展功能

全部展开

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

版本历史记录

在 R2013b 中推出

全部展开

另请参阅

| | | |

主题