ドキュメンテーション

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

setxor

2 つの配列の排他的論理和のセット

構文

  • C = setxor(A,B)
  • C = setxor(A,B,'rows')
  • [C,ia,ib] = setxor(A,B)
  • [C,ia,ib] = setxor(A,B,'rows')
  • [C,ia,ib] = setxor(___,setOrder)
  • [C,ia,ib] = setxor(A,B,'legacy')
  • [C,ia,ib] = setxor(A,B,'rows','legacy')

説明

C = setxor(A,B) は、AB の交差 (対称差) にないデータを返します。

  • AB が数値配列、論理配列、文字配列、カテゴリカル配列または文字列のセル配列の場合、setxor は、A または B の一方に出現し、両方には出現しない値を返します。C の値は並べ替えられた順序になっています。

  • AB がテーブルの場合、setxor は、2 つのテーブルの一方のみに出現する行を返します。テーブル C の行は並べ替えられた順序になっています。

C = setxor(A,B,'rows') は、AB の各行を 1 つのエンティティとして扱い、AB の交差部分に存在しない行列の行を返します。C の行は並べ替えられた順序になっています。

'rows' オプションはセル配列をサポートしません。

[C,ia,ib] = setxor(A,B) はインデックス ベクトル ia および ib も返します。

  • AB が数値配列、論理配列、文字配列、カテゴリカル配列または文字列のセル配列の場合、C は、要素 A(ia)B(ib) が並べ替えられた組み合わせになります。

  • AB がテーブルの場合、CA(ia,:)B(ib,:) の行を並べ替えた組み合わせになります。

[C,ia,ib] = setxor(A,B,'rows') は、CA(ia,:)B(ib,:) の並べ替えた行の組み合わせになるようなインデックス ベクトル ia および ib も返します。

[C,ia,ib] = setxor(___,setOrder) は前出の構文の入力引数のいずれかを使用して特定の順序で C を返します。setOrder='sorted' はソート順で C の値 (または行) を返します。setOrder='stable'AB と同じ順序で C の値 (または行) を返します。値が指定されていない場合、既定値は 'sorted' です。

[C,ia,ib] = setxor(A,B,'legacy')[C,ia,ib] = setxor(A,B,'rows','legacy') は、R2012b およびそれ以前のリリースの関数 setxor の動作を保持します。

'legacy' オプションはカテゴリカル配列またはテーブルをサポートしません。

すべて展開する

2 つのベクトルの対称差

共通の値を 1 つもつ 2 つのベクトルを定義します。

A = [5 1 3 3 3]; B = [4 1 2];

交差部分にない AB の値を検索します。

C = setxor(A,B)
C =

     2     3     4     5

2 つのテーブルの対称差

共通の行をもつ 2 つのテーブルを定義します。

A = table([1:5]',['A';'B';'C';'D';'E'],logical([0;1;0;1;0]))
B = table([1:2:10]',['A';'C';'E';'G';'I'],logical(zeros(5,1)))
A = 

    Var1    Var2    Var3 
    ----    ----    -----
    1       A       false
    2       B       true 
    3       C       false
    4       D       true 
    5       E       false


B = 

    Var1    Var2    Var3 
    ----    ----    -----
    1       A       false
    3       C       false
    5       E       false
    7       G       false
    9       I       false

交差部分にない AB の行を求めます。

C = setxor(A,B)
C = 

    Var1    Var2    Var3 
    ----    ----    -----
    2       B       true 
    4       D       true 
    7       G       false
    9       I       false

2 つのベクトルの対称差と異なる値へのインデックス

共通の値を 1 つもつ 2 つのベクトルを定義します。

A = [5 1 3 3 3]; B = [4 1 2];

交差部分にない AB の値や、iaib などのインデックス ベクトルを検索します。

[C,ia,ib] = setxor(A,B)
C =

     2     3     4     5


ia =

     3
     1


ib =

     3
     1

C は、要素 A(ia)B(ib) を並べ替えた組み合わせです。

2 つのテーブルの対称差と異なる行へのインデックス

5 人の性別、年齢および身長のテーブル A を定義します。

A = table(['M';'M';'F'],[27;52;31],[74;68;64],...
'VariableNames',{'Gender' 'Age' 'Height'},...
'RowNames',{'Ted' 'Fred' 'Betty'})
A = 

             Gender    Age    Height
             ------    ---    ------
    Ted      M         27     74    
    Fred     M         52     68    
    Betty    F         31     64    

A と同じ変数をもつテーブル B を定義します。

B = table(['F';'M'],[64;68],[31;47],...
'VariableNames',{'Gender' 'Height' 'Age'},...
'RowNames',{'Meg' 'Joe'})
B = 

           Gender    Height    Age
           ------    ------    ---
    Meg    F         64        31 
    Joe    M         68        47 

交差部分にない AB の行およびインデックス ベクトル iaib を求めます。

[C,ia,ib] = setxor(A,B)
C = 

            Gender    Age    Height
            ------    ---    ------
    Ted     M         27     74    
    Joe     M         47     68    
    Fred    M         52     68    


ia =

     1
     2


ib =

     2

C は、要素 A(ia,:)B(ib,:) を並べ替えた組み合わせです。

2 つの行列の行の対称差

共通の行をもつ 2 つの行列を定義します。

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

交差部分にない AB の行や、iaib などのインデックス ベクトルを検索します。

[C,ia,ib] = setxor(A,B,'rows')
C =

     7     7     1
     7     7     2
     7     8     9


ia =

     2
     1


ib =

     3

C は、A(ia,:)B(ib,:) の行を並べ替えた組み合わせです。

指定した順序の 2 つのベクトルの対称差

setOrder 引数を使って C の値の順序を指定します。

C の値を AB と同じ順序にする場合、'stable' を指定します。

A = [5 1 3 3 3]; B = [4 1 2];
[C,ia,ib] = setxor(A,B,'stable')
C =

     5     3     4     2


ia =

     1
     3


ib =

     1
     3

または、関数 'sorted' を指定できます。

[C,ia,ib] = setxor(A,B,'sorted')
C =

     2     3     4     5


ia =

     3
     1


ib =

     3
     1

NaN を含むベクトルの対称差

NaN を含む 2 つのベクトルを定義します。

A = [5 NaN NaN]; B = [5 NaN NaN];

AB のベクトルの対称差を検索します。

C = setxor(A,B)
C =

   NaN   NaN   NaN   NaN

関数 setxorNaN 値を個別のものとして処理します。

末尾に空白文字がある文字列のセル配列

文字列のセル配列 A を作成します。

A = {'dog','cat','fish','horse'};

文字列のセル配列 B を作成します。一部の文字列の末尾には空白文字があります。

B = {'dog ','cat','fish ','horse'};

AB の交差部分にない文字列を探します。

[C,ia,ib] = setxor(A,B)
C = 

    'dog'    'dog '    'fish'    'fish '


ia =

     1
     3


ib =

     1
     3

setxor は、文字列のセル配列内の末尾の空白文字を別個の文字として処理します。

異なるクラスと形状のベクトルの対称差

列ベクトル文字配列を作成します。

A = ['A';'B';'C'], class(A)
A =

A
B
C


ans =

char

数値型 double の要素を含む行ベクトルを作成します。

B = [66 67 68], class(B)
B =

    66    67    68


ans =

double

AB の対称差を検索します。

C = setxor(A,B)
C =

A
D

結果は、列ベクトルの文字配列です。

class(C)
ans =

char

文字と文字列のセル配列の対称差

文字配列 A を作成します。

A = ['cat';'dog';'fox';'pig'];
class(A)
ans =

char

文字列のセル配列 B を作成します。

B={'dog','cat','fish','horse'};
class(B)
ans =

cell

AB の交差部分にない文字列を探します。

C = setxor(A,B)
C = 

    'fish'
    'fox'
    'horse'
    'pig'

結果 C は文字列のセル配列です。

class(C)
ans =

cell

setxor のレガシ動作の保持

'legacy' フラグを使用して、コード内の R2012b およびそれ以前のリリースの setxor の動作を保持します。

現在の動作における AB の対称差を検出します。

A = [5 1 3 3 3]; B = [4 1 2 2];
[C1,ia1,ib1] = setxor(A,B)
C1 =

     2     3     4     5


ia1 =

     3
     1


ib1 =

     3
     1

対称差を検出し、レガシ動作を維持します。

[C2,ia2,ib2] = setxor(A,B,'legacy')
C2 =

     2     3     4     5


ia2 =

     5     1


ib2 =

     4     1

入力引数

すべて展開する

A,B — 入力配列数値配列 | 論理配列 | 文字配列 | カテゴリカル配列 | 文字列のセル配列 | テーブル

入力配列。数値配列、論理配列、文字配列、カテゴリカル配列、文字列のセル配列またはテーブルとして指定します。

A および B は次の例外を伴う同一クラスに属していなければなりません。

  • logicalchar、およびすべての数値クラスは double 配列と組み合わせることができます。

  • 文字列のセル配列は char 配列と組み合わせることができます。

  • カテゴリカル配列は、文字列のセル配列または単一の文字列と組み合わせることができます。

AB の両方が順序カテゴリカル配列である場合は、順序を含めて同じカテゴリ セットでなければなりません。AB の両方が順序配列でない場合、同じカテゴリ セットをもつ必要はなく、カテゴリ名を使用して比較が実行されます。この場合、C のカテゴリは、A および B からのカテゴリの和集合を並べ替えたものになります。

'rows' オプションを指定した場合、A および B は同じ数の列をもたなければなりません。

AB がテーブルの場合、その変数名は同じでなければなりません。反対に、行の名前は問題ではありません。値が同じで名前が異なる 2 つの行は、等しいと見なされます。

さらに、A および B は次のクラス メソッドをもつオブジェクトにすることができます。

  • sort (または 'rows' オプションの sortrows)

  • eq

  • ne

オブジェクト クラスのメソッドは、相互に一貫していなければなりません。これらのオブジェクトは、同じルート クラスから導出した異なるタイプの配列を含みます。

setOrder — 順序フラグ'sorted' (既定値) | 'stable'

'sorted' または 'stable' として指定される順序フラグは、C で値 (または行) の順序を示します。

順序フラグ意味
'sorted'C の値 (または行) は並べ替えられた順序で返されます。以下に例を示します。C = setxor([5 1 3],[4 1 2],'sorted')C = [2 3 4 5] を返します。
'stable'C の値 (または行) は A および B と同じ順序で返されます。以下に例を示します。C = setxor([5 1 3],[4 1 2],'stable')C = [5 3 4 2] を返します。

出力引数

すべて展開する

C — 対称差配列ベクトル | 行列 | テーブル

対称差配列。ベクトル、行列またはテーブルとして返されます。入力 A および B がテーブルの場合、生成されるテーブル C の変数の順番は、A の変数の順番と同じになります。

入力がベクトルまたは行列で、'legacy' フラグを指定していないときの C の形状を次に説明します。

  • 'rows' フラグを指定していない場合、AB の両方が行ベクトルでない限り、C は列ベクトルです。

  • 'rows' フラグを指定していないときに AB の両方が行ベクトルである場合、C は行ベクトルです。

  • 'rows' フラグを指定した場合、C は、交差部分に含まれない AB の行を含む行列です。

  • A のすべての値 (または行) が B にも存在する場合、C は空行列です。

AB の入力のクラスによって、C のクラスが決まります。

  • AB のクラスが同じである場合、C は同じクラスになります。

  • char または非倍精度数値クラスを double と組み合わせる場合、C は非倍精度入力と同じクラスになります。

  • logical クラスを double と組み合わせる場合、Cdouble になります。

  • 文字列のセル配列を char と組み合わせる場合、C は文字列のセル配列になります。

  • カテゴリカル配列を文字列のセル配列または単一の文字列と組み合わせた場合、C はカテゴリカル配列になります。

iaA へのインデックス列ベクトル

'legacy' フラグを指定していないときに列ベクトルとして返される、A へのインデックス。iaは、対称差に寄与する A 内の値 (または行) を特定します。A 内だけに出現する繰り返しの値 (または行) がある場合、ia は値 (または行) の最初の出現位置に対するインデックスを含みます。

ibB へのインデックス列ベクトル

'legacy' フラグを指定していないときに列ベクトルとして返される、B へのインデックス。ibは、対称差に寄与する B 内の値 (または行) を特定します。B 内だけに出現する繰り返しの値 (または行) がある場合、ib は値 (または行) の最初の出現位置に対するインデックスを含みます。

詳細

すべて展開する

ヒント

  • テーブルの変数のサブセットに関する対称差を求めるには、列の添字を使用できます。たとえば、setxor(A(:,vars),B(:,vars)) を使用できます。ここで、vars は、正の整数、正の整数のベクトル、変数名、変数名のセル配列または論理ベクトルです。

この情報は役に立ちましたか?