ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

vertcat

配列の垂直方向の連結

説明

C = vertcat(A,B) は、AB のサイズに互換性がある場合 (最初の次元を除く次元の長さが一致する場合) に、BA の末尾に垂直方向に連結します。

C = vertcat(A1,A2,…,An) は、A1A2、…、An を垂直方向に連結します。

vertcat は、大かっこを使用して配列を垂直方向に連結することと同じです。たとえば、AB が互換性がある配列である場合、[A; B]vertcat(A,B) と同等です。

すべて折りたたむ

2 つの行列を作成して垂直方向に連結します。最初は大かっこの表記を使用し、次に vertcat を使用します。

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

     1     2     3
     4     5     6

B = [7 8 9]
B = 1×3

     7     8     9

C = [A; B]
C = 3×3

     1     2     3
     4     5     6
     7     8     9

D = vertcat(A,B)
D = 3×3

     1     2     3
     4     5     6
     7     8     9

3 つの行と 5 つの変数をもつ table A を作成します。

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

    Thomas     5       M         45        45         'NY'   
    Gordon     6       M         41        32         'CA'   
    Percy      5       M         40        34         'MA'   

順序を除き、A と同じ変数をもつ table B を作成します。

B = table(['F';'M';'F'],[6;6;5],{'AZ';'NH';'CO'},[31;42;33],[39;43;40],...
    'VariableNames',{'Gender' 'Age' 'Birthplace' 'Weight' 'Height'})
B=3×5 table
    Gender    Age    Birthplace    Weight    Height
    ______    ___    __________    ______    ______

      F        6        'AZ'         31        39  
      M        6        'NH'         42        43  
      F        5        'CO'         33        40  

table AB を垂直方向に連結します。C の変数は A の変数とと同じ順序になり、既定の行の名前が B の行に対して使用されています。

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

    Thomas     5       M         45        45         'NY'   
    Gordon     6       M         41        32         'CA'   
    Percy      5       M         40        34         'MA'   
    Row4       6       F         39        31         'AZ'   
    Row5       6       M         43        42         'NH'   
    Row6       5       F         40        33         'CO'   

日付文字ベクトル、string 日付および datetime を連結して 1 列の日付にします。結果は datetime の列ベクトルになります。

chardate = '2016-03-24';
strdate = "2016-04-19";
t = datetime('2016-05-10','InputFormat','yyyy-MM-dd');
C = vertcat(chardate,strdate,t)
C = 3x1 datetime array
   24-Mar-2016
   19-Apr-2016
   10-May-2016

3 つの string 配列を単一の配列に連結します。

A1 = ["str1" "str2"];
A2 = ["str3" "str4"];
A3 = ["str5" "str6"];
C = vertcat(A1,A2,A3)
C = 3x2 string array
    "str1"    "str2"
    "str3"    "str4"
    "str5"    "str6"

2 つの行列が含まれる cell 配列を作成します。これらの行列を cell 配列から 1 つの行列に垂直方向に連結します。

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

     1     2
     3     4
     5     6
     7     8

入力引数

すべて折りたたむ

1 番目の入力。スカラー、ベクトル、行列、多次元配列、table または timetable として指定します。

2 番目の入力。スカラー、ベクトル、行列、多次元配列、table または timetable として指定します。

  • B の要素が 1 番目の入力の末尾に最初の次元に沿って連結されます。入力引数のサイズには互換性がなければなりません。たとえば、最初の入力が 3 行 2 列のサイズの行列の場合、B に 2 列なければなりません。

  • 異なるタイプの有効な組み合わせを連結できます。詳細については、異なるクラスの有効な組み合わせを参照してください。

入力のリスト。指定される順序で連結する要素のコンマ区切りリストとして指定します。

  • 入力のサイズは互換性がなければなりません。たとえば、A1 が長さ m の行ベクトルである場合、他の入力にはいずれも縦方向に連結する列が m 列なければなりません。

  • 異なるタイプの有効な組み合わせを連結できます。詳細については、異なるクラスの有効な組み合わせを参照してください。

アルゴリズム

空の配列を空でない配列に連結する場合、vertcat は出力で空の配列を除外します。たとえば、vertcat([1; 2],[]) は列ベクトル [1; 2] を返します。

すべての入力引数が空であり、サイズに互換性がある場合、vertcat は入力が空でない場合と同じ出力サイズの空の配列を返します。たとえば、vertcat(zeros(1,0),zeros(2,0)) は 3 行 0 列の空の配列を返します。入力サイズに互換性がない場合、vertcat は 0 行 0 列の空の配列を返します。

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

R2006a より前に導入