head

获取数组或表的顶行

语法

head(A)

head(A,k)

B = head(___)

说明

head(A) 在命令行窗口中显示数组、表或时间表 A 的前八行，但不存储值。

head(A,k) 显示 A 的前 k 行。

B = head(___) 返回 A 中任一上述语法所请求的行。B 的数据类型与 A 的数据类型相同。

示例

显示矩阵的前八行

创建一个有 100 行的矩阵，并显示矩阵的前八行。

如果不指定输出参量，head 不会返回值。它只显示矩阵的顶部。

A = repmat((1:100)',1,4);
head(A)

     1     1     1     1
     2     2     2     2
     3     3     3     3
     4     4     4     4
     5     5     5     5
     6     6     6     6
     7     7     7     7
     8     8     8     8

显示表的前三行

从包含 1468 行的文件创建一个表。

T = readtable("outages.csv","TextType","string");
size(T)

ans = 1×2

        1468           6

显示前三行。如果不指定输出参量，head 不会返回值。它只显示表的顶部。

head(T,3)

      Region          OutageTime        Loss     Customers     RestorationTime         Cause     
    ___________    ________________    ______    __________    ________________    ______________

    "SouthWest"    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    "winter storm"
    "SouthEast"    2003-01-23 00:49    530.14    2.1204e+05                 NaT    "winter storm"
    "SouthEast"    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    "winter storm"

返回表的前八行

通过从电子表格中读取数据来创建一个表。显示该表的大小，根据显示它有 1468 行。

T = readtable("outages.csv","TextType","string");
size(T)

ans = 1×2

        1468           6

返回另一个包含 T 的前八行的表。

T2 = head(T)

T2=8×6 table
      Region          OutageTime        Loss     Customers     RestorationTime           Cause      
    ___________    ________________    ______    __________    ________________    _________________

    "SouthWest"    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    "winter storm"   
    "SouthEast"    2003-01-23 00:49    530.14    2.1204e+05                 NaT    "winter storm"   
    "SouthEast"    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    "winter storm"   
    "West"         2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    "equipment fault"
    "MidWest"      2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    "severe storm"   
    "West"         2003-06-18 02:49         0             0    2003-06-18 10:54    "attack"         
    "West"         2004-06-20 14:39    231.29           NaN    2004-06-20 19:16    "equipment fault"
    "West"         2002-06-06 19:28    311.86           NaN    2002-06-07 00:51    "equipment fault"

输入参数

A — 输入数据

数组 | 元胞数组 | 表 | 时间表

输入数据，指定为数组、元胞数组、表或时间表。

k — 要提取的行数

正整数

要提取的行数，指定为正整数。如果 A 少于 k 行，则 head 将返回 A 的所有行。

扩展功能

tall 数组

对行数太多而无法放入内存的数组进行计算。

此函数完全支持 tall 数组。有关详细信息，请参阅 tall 数组。

您可以将 head 和 tail 用于任何具有有效基本数据类型（single、double、int8、datetime、table 等）的 tall 数组。

如果您不确定 gather(A) 返回的结果是否能够完全存入内存，请使用 gather(head(A)) 或 gather(tail(A))。这两个命令还是会完全计算 tall 数组 A，但只将一小部分结果返回到内存中。

GPU 数组

通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

此函数完全支持 GPU 数组。有关详细信息，请参阅Run MATLAB Functions on a GPU (Parallel Computing Toolbox)。

分布式数组

使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

此函数完全支持分布式数组。有关详细信息，请参阅Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox)。

版本历史记录

在 R2016b 中推出

R2023a: 获取数组的顶行

使用 head 显示或返回向量、矩阵、多维数组或元胞数组的顶行。在以前的版本中，head 仅支持表、时间表和 tall 数组。

R2022b: 在没有指定输出参量的情况下调用 head 不会将输出存储在 ans 中

当您在没有指定输出参量的情况下调用 head 时，head 会显示表中所选行，但不会将输出存储在 ans 变量中。在以前的版本中，在没有指定输出参量的情况下调用 head 会导致将输出存储在 ans 中。

通常不推荐在实时脚本中调用 head。请改为通过键入不带分号的变量名称来显示表或时间表。实时编辑器提供了一个小组件，使您能够检查整个表或时间表。但是，如果您在实时脚本中调用 head，建议您将输出赋给变量，以便实时脚本为输出创建一个小组件。

另请参阅

tail | topkrows | trimdata | tall | gather | table | timetable | summary

主题

• 访问表中的数据
• Index and View Tall Array Elements