horzcat

水平串联数组

全页折叠

语法

C = horzcat(A,B)
C = horzcat(A1,A2,…,An)

说明

当 A 和 B 具有兼容的大小时（除第二个维度以外，其余维度的长度均需匹配），C = horzcat(A,B) 会将 B 水平串联到 A 的末尾。

示例

C = horzcat(A1,A2,…,An) 可水平串联 A1、A2、…、An。

horzcat 等效于使用方括号来水平串联或追加数组。例如，当 A 和 B 是兼容数组时，[A,B] 和 [A B] 与 horzcat(A,B) 相同。

示例

示例

全部折叠

打开实时脚本

水平串联两个矩阵。

创建两个矩阵，并使用方括号表示法将第二个矩阵水平追加到第一个矩阵。

A = [1 2; 3 4]
A = 2×2

     1     2
     3     4


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

     4     5     6
     7     8     9


C = [A,B]
C = 2×5

     1     2     4     5     6
     3     4     7     8     9

现在，使用 horzcat 将第二个矩阵水平追加到第一个矩阵。

D = horzcat(A,B)
D = 2×5

     1     2     4     5     6
     3     4     7     8     9
打开实时脚本

创建一个包含三行和两个变量的表 A。 

A = table([5;6;5],['M';'M';'M'],...
    'VariableNames',{'Age' 'Gender'},...
    'RowNames',{'Thomas' 'Gordon' 'Percy'})
A=3×2 table
              Age    Gender
              ___    ______

    Thomas     5       M   
    Gordon     6       M   
    Percy      5       M

创建一个包含三行和三个变量的表 B。 

B = table([45;41;40],[45;32;34],{'NY';'CA';'MA'},...
    'VariableNames',{'Height' 'Weight' 'Birthplace'},...
    'RowNames',{'Percy' 'Gordon' 'Thomas'})
B=3×3 table
              Height    Weight    Birthplace
              ______    ______    __________

    Percy       45        45        {'NY'}  
    Gordon      41        32        {'CA'}  
    Thomas      40        34        {'MA'}

水平串联 A 和 B。C 中的行顺序与 A 中的顺序相匹配。 

C = horzcat(A,B)
C=3×5 table
              Age    Gender    Height    Weight    Birthplace
              ___    ______    ______    ______    __________

    Thomas     5       M         40        34        {'MA'}  
    Gordon     6       M         41        32        {'CA'}  
    Percy      5       M         45        45        {'NY'}
打开实时脚本

将日期字符向量、字符串日期和日期时间串联成一个日期行。结果是一个日期时间行向量。

chardate = '2016-03-24';
strdate = "2016-04-19";
t = datetime('2016-05-10','InputFormat','yyyy-MM-dd');
C = horzcat(chardate,strdate,t)
C = 1×3 datetime
   24-Mar-2016   19-Apr-2016   10-May-2016
打开实时脚本

将三个字符串数组串联成一个数组。

A1 = ["str1"; "str2"];
A2 = ["str3"; "str4"];
A3 = ["str5"; "str6"];
C = horzcat(A1,A2,A3)
C = 2×3 string
    "str1"    "str3"    "str5"
    "str2"    "str4"    "str6"
打开实时脚本

创建一个包含两个矩阵的元胞数组。将元胞数组中的矩阵水平串联成一个矩阵。 

M1 = [1 2; 3 4];
M2 = [5 6 7; 8 9 10];
A1 = {M1,M2};
C = horzcat(A1{:})
C = 2×5

     1     2     5     6     7
     3     4     8     9    10

输入参数

全部折叠

第一个输入，指定为标量、向量、矩阵、多维数组、表或时间表。

第二个输入，指定为标量、向量、矩阵、多维数组、表或时间表。

  • B 的元素沿第二个维度串联到第一个输入的末尾。输入参量的大小必须兼容。例如，如果第一个输入是大小为 3×2 的矩阵，则 B 必须有 3 行。

  • 所有表输入必须有唯一的变量名称。如果行名称出现在表输入中，行名称必须相同，但其顺序可以不同。如果行名称存在，则 horzcat 通过匹配行名称进行串联；如果行名称不存在，则通过匹配表位置进行串联。对于表输入，horzcat 还串联与表变量相关的属性值。使用对应输入的第一个非空（或非默认）属性值来赋予输出表的其他属性值。

  • 所有时间表输入必须有唯一变量名称。每个时间表输入中的行时间必须相同，但顺序可以不同。horzcat 通过匹配行时间进行串联。对于时间表输入，horzcat 还会串联与时间表变量和关联到输入的事件相关的属性值。使用对应输入的第一个非空（或非默认）属性值来赋予输出时间表的其他属性值。

  • 您可以串联不同类型的有效组合。有关串联字符数组、逻辑数组和数值类型的详细信息，请参阅不同类的有效合并。

输入的列表，指定为以逗号分隔的元素列表，这些元素按其在列表中指定的顺序串联。

  • 输入必须具有兼容的大小。例如，如果 A1 是长度为 m 的列向量，则其余输入必须各有 m 行才能水平串联。

  • 所有表输入必须有唯一的变量名称。如果行名称出现在表输入中，行名称必须相同，但其顺序可以不同。如果行名称存在，则 horzcat 通过匹配行名称进行串联；如果行名称不存在，则通过匹配表位置进行串联。对于表输入，horzcat 还串联与表变量相关的属性值。使用对应输入的第一个非空（或非默认）属性值来赋予输出表的其他属性值。

  • 所有时间表输入必须有唯一变量名称。每个时间表输入中的行时间必须相同，但顺序可以不同。horzcat 通过匹配行时间进行串联。对于时间表输入，horzcat 还会串联与时间表变量和关联到输入的事件相关的属性值。使用对应输入的第一个非空（或非默认）属性值来赋予输出时间表的其他属性值。

  • 您可以串联不同类型的有效组合。有关串联字符数组、逻辑数组和数值类型的详细信息，请参阅不同类的有效合并。

提示

  • 要通过水平串联字符串、字符向量或字符向量元胞数组来构造文本，请使用 strcat 函数。

  • 要从字符向量元胞数组或字符串数组构造一段带分隔符的文本，请使用 strjoin 函数。

算法

当将空数组串联到非空数组时，horzcat 会在输出中略去空数组。例如，horzcat([1 2],[]) 返回行向量 [1 2]。

如果所有输入参量均为空且具有兼容的大小，则 horzcat 返回空数组，其大小等于输入为非空时的输出大小。例如，horzcat(zeros(0,1),zeros(0,2)) 返回 0×3 空数组。如果输入大小不兼容，则 horzcat 返回 0×0 空数组。

扩展功能

全部展开

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

版本历史记录

在 R2006a 之前推出

另请参阅

| | |

主题