setxor
Set exclusive OR of two arrays
Syntax
Description
returns the data ofC
= setxor(A,B
)A
andB
that are not in their intersection (the symmetric difference), with no repetitions. That is,setxor
returns the data that occurs inA
orB
, but not both.C
is in sorted order.
If
A
andB
are tables or timetables, thensetxor
returns the rows that occur in one or the other of the two tables, but not both. For timetables,setxor
takes row times into account to determine equality, and sorts the output timetableC
by row times.
andC
= setxor(A,B
,___,'rows')
treat each row ofC
= setxor(A,B
,'rows',___)A
and each row ofB
成一个在tities and returns the rows ofA
andB
that are not in their intersection, with no repetitions. You must specifyA
andB
and optionally can specifysetOrder
.
The'rows'
option does not support cell arrays, unless one of the inputs is either a categorical array or a datetime array.
[
also returns index vectorsC
,ia
,ib
] = setxor(___)ia
andib
using any of the previous syntaxes.
Generally, the values in
C
are a sorted combination of the elements ofA(ia)
andB(ib)
.If the
'rows'
option is specified, thenC
is a sorted combination of the rows ofA(ia,:)
andB(ib,:)
.If
A
andB
are tables or timetables, thenC
is a sorted combination of the rows ofA(ia,:)
andB(ib,:)
.
Examples
Symmetric Difference of Two Vectors
Define two vectors with a value in common.
A = [5 1 3 3 3]; B = [4 1 2];
Find the values ofA
andB
that are not in their intersection.
C = setxor(A,B)
C =1×42 3 4 5
Symmetric Difference of Two Tables
Define two tables with rows in common.
A = table([1:5]',['A';'B';'C';'D';'E'],logical([0;1;0;1;0]))
A=5×3 tableVar1 Var2 Var3 ____ ____ _____ 1 A false 2 B true 3 C false 4 D true 5 E false
B = table([1:2:10]',['A';'C';'E';'G';'I'],logical(zeros(5,1)))
B=5×3 tableVar1 Var2 Var3 ____ ____ _____ 1 A false 3 C false 5 E false 7 G false 9 I false
Find the rows ofA
andB
that are not in their intersection.
C = setxor(A,B)
C=4×3 tableVar1 Var2 Var3 ____ ____ _____ 2 B true 4 D true 7 G false 9 I false
Symmetric Difference of Two Vectors and Indices to Different Values
Define two vectors with a value in common.
A = [5 1 3 3 3]; B = [4 1 2];
Find the values ofA
andB
that are not in their intersection as well as the index vectorsia
andib
.
[C,ia,ib] = setxor(A,B)
C =1×42 3 4 5
ia =2×13 1
ib =2×13 1
C
is a sorted combination of the elementsA(ia)
andB(ib)
.
Symmetric Difference of Two Tables and Indices to Different Rows
Define a table,A
, of gender, age, and height for five people.
A = table(['M';'M';'F'],[27;52;31],[74;68;64],...'VariableNames',{'Gender''Age''Height'},...'RowNames',{'Ted''Fred''Betty'})
A=3×3 tableGender Age Height ______ ___ ______ Ted M 27 74 Fred M 52 68 Betty F 31 64
Define a table,B
, with the same variables asA
.
B = table(['F';'M'],[64;68],[31;47],...'VariableNames',{'Gender''Height''Age'},...'RowNames',{'Meg''Joe'})
B=2×3 tableGender Height Age ______ ______ ___ Meg F 64 31 Joe M 68 47
Find the rows ofA
andB
that are not in their intersection, as well as the index vectorsia
andib
.
[C,ia,ib] = setxor(A,B)
C=3×3 tableGender Age Height ______ ___ ______ Ted M 27 74 Joe M 47 68 Fred M 52 68
ia =2×11 2
ib = 2
C
is a sorted combination of the elementsA(ia,:)
andB(ib,:)
.
Symmetric Difference of Rows in Two Matrices
Define two matrices with rows in common.
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];
Find the rows ofA
andB
that are not in their intersection as well as the index vectorsia
andib
.
[C,ia,ib] = setxor(A,B,'rows')
C =3×37 7 1 7 7 2 7 8 9
ia =2×12 1
ib = 3
C
is a sorted combination of the rows ofA(ia,:)
andB(ib,:)
.
Symmetric Difference of Two Vectors in Specified Order
Use thesetOrder
argument to specify the ordering of the values inC
.
Specify'stable'
if you want the values inC
to have the same order asA
andB
.
A = [5 1 3 3 3]; B = [4 1 2]; [C,ia,ib] = setxor(A,B,'stable')
C =1×45 3 4 2
ia =2×11 3
ib =2×11 3
Alternatively, you can specify'sorted'
order.
[C,ia,ib] = setxor(A,B,'sorted')
C =1×42 3 4 5
ia =2×13 1
ib =2×13 1
Symmetric Difference of Vectors Containing NaNs
Define two vectors containingNaN
.
A = [5 NaN NaN]; B = [5 NaN NaN];
Find the symmetric difference of vectorsA
andB
.
C = setxor(A,B)
C =1×4NaN NaN NaN NaN
Thesetxor
function treatsNaN
values as distinct.
Cell Array of Character Vectors with Trailing White Space
Create a cell array of character vectors,A
.
A = {'dog','cat','fish','horse'};
Create a cell array of character vectors,B
, where some of the vectors have trailing white space.
B = {'dog ','cat','fish ','horse'};
Find the character vectors that are not in the intersection ofA
andB
.
[C,ia,ib] = setxor(A,B)
C =1x4 cell{'dog'} {'dog '} {'fish'} {'fish '}
ia =2×11 3
ib =2×11 3
setxor
treats trailing white space in cell arrays of character vectors as distinct characters.
Symmetric Difference of Vectors of Different Classes and Shapes
Create a column vector character array.
A = ['A';'B';'C'], class(A)
A =3x1 char array'A' 'B' 'C'
ans = 'char'
Create a row vector containing elements of numeric typedouble
.
B = [66 67 68], class(B)
B =1×366 67 68
ans = 'double'
Find the symmetric difference ofA
andB
.
C = setxor(A,B)
C =2x1 char array' A ' ' D '
The result is a column vector character array.
class(C)
ans = 'char'
Symmetric Difference of Char and Cell Array of Character Vectors
Create a character vector,A
.
A = ['cat';'dog';'fox';'pig']; class(A)
ans = 'char'
Create a cell array of character vectors,B
.
B={'dog','cat','fish','horse'}; class(B)
ans = 'cell'
Find the character vectors that are not in the intersection ofA
andB
.
C = setxor(A,B)
C =4x1 cell{'fish' } {'fox' } {'horse'} {'pig' }
The result,C
, is a cell array of character vectors.
class(C)
ans = 'cell'
Preserve Legacy Behavior of setxor
Use the'legacy'
flag to preserve the behavior ofsetxor
from R2012b and prior releases in your code.
Find the symmetric difference ofA
andB
with the current behavior.
A = [5 1 3 3 3]; B = [4 1 2 2]; [C1,ia1,ib1] = setxor(A,B)
C1 =1×42 3 4 5
ia1 =2×13 1
ib1 =2×13 1
Find the symmetric difference and preserve the legacy behavior.
[C2,ia2,ib2] = setxor(A,B,'legacy')
C2 =1×42 3 4 5
ia2 =1×25 1
ib2 =1×24 1
Input Arguments
A,B
—Input arrays
numeric arrays|logical arrays|character arrays|string arrays|categorical arrays|datetime arrays|duration arrays|cell arrays of character vectors|tables|timetables
Input arrays, specified as numeric arrays, logical arrays, character arrays, string arrays, categorical arrays, datetime arrays, duration arrays, cell arrays of character vectors, tables, or timetables. If you specify the'rows'
option,A
andB
must have the same number of columns.
A
andB
must belong to the same class with the following exceptions:
logical
,char
, and all numeric classes can combine withdouble
arrays.Cell arrays of character vectors can combine with character arrays or string arrays.
Categorical arrays can combine with character arrays, cell arrays of character vectors, or string arrays.
Datetime arrays can combine with cell arrays of date character vectors or single date character vectors.
There are additional requirements forA
andB
based on data type:
If
A
andB
are both ordinal categorical arrays, they must have the same sets of categories, including their order. If neitherA
norB
are ordinal, they need not have the same sets of categories, and the comparison is performed using the category names. In this case, the categories ofC
are the sorted union of the categories fromA
andB
.If
A
andB
are tables or timetables, they must have the same variable names (except for order). For tables, row names are ignored, so that two rows that have the same values, but different names, are considered equal. For timetables, row times are taken into account, so that two rows that have the same values, but different times, are not considered equal.If
A
andB
are datetime arrays, they must be consistent with each other in whether they specify a time zone.
A
andB
also can be objects with the following class methods:
sort
(orsortrows
for the'rows'
option)eq
ne
The object class methods must be consistent with each other. These objects include heterogeneous arrays derived from the same root class. For example,A
andB
can be arrays of handles to graphics objects.
setOrder
—Order flag
'sorted'
(默认)|'stable'
Order flag, specified as'sorted'
or'stable'
, indicates the order of the values (or rows) inC
.
Flag | Description |
---|---|
'sorted' |
The values (or rows) in Example C = setxor([5 1 3],[4 1 2],'sorted')
C = 2 3 4 5 |
'stable' |
The values (or rows) in Example C = setxor([5 1 3],[4 1 2],'stable')
C = 5 3 4 2 |
Data Types:char
|string
Output Arguments
C
— Symmetric difference array
vector | matrix | table | timetable
Symmetric difference array, returned as a vector, matrix, table, or timetable. If the inputsA
andB
are tables or timetables, then the order of the variables inC
is the same as the order of the variables inA
.
The following describes the shape ofC
when the inputs are vectors or matrices and when the'legacy'
flag is not specified:
If the
'rows'
flag is not specified, thenC
is a column vector unless bothA
andB
are row vectors, in which caseC
is a row vector. For example,setxor([],[1 2])
returns a column vector.If the
'rows'
flag is specified, thenC
is a matrix containing the rows ofA
andB
that are not in the intersection.If all the values (or rows) of
A
are also inB
, thenC
is empty.
The class of the inputsA
andB
determines the class ofC
:
If the class of
A
andB
are the same, thenC
is the same class.If you combine a
char
or nondouble numeric class withdouble
, thenC
is the same class as the nondouble input.If you combine a
logical
class withdouble
, thenC
isdouble
.If you combine a cell array of character vectors with
char
, thenC
is a cell array of character vectors.If you combine a categorical array with a character vector, cell array of character vectors, or string, then
C
is a categorical array.If you combine a datetime array with a cell array of date character vectors or single date character vector, then
C
is a datetime array.If you combine a string array with a character vector or cell array of character vectors, then
C
is a string array.
ia
— Index toA
column vector
Index toA
, returned as a column vector when the'legacy'
flag is not specified.ia
identifies the values (or rows) inA
that contribute to the symmetric difference. If there is a repeated value (or row) appearing exclusively inA
, thenia
contains the index to the first occurrence of the value (or row).
ib
— Index toB
column vector
Index toB
, returned as a column vector when the'legacy'
flag is not specified.ib
identifies the values (or rows) inB
that contribute to the symmetric difference. If there is a repeated value (or row) appearing exclusively inB
, thenib
contains the index to the first occurrence of the value (or row).
Tips
To find the symmetric difference with respect to a subset of variables from a table or timetable, you can use column subscripting. For example, you can use
setxor(A(:,
, wherevars
),B(:,vars
))vars
is a positive integer, a vector of positive integers, a variable name, a cell array of variable names, or a logical vector. Alternatively, you can usevartype
to create a subscript that selects variables of a specified type.
Extended Capabilities
Tall Arrays
Calculate with arrays that have more rows than fit in memory.
Usage notes and limitations:
The
'stable'
and'legacy'
options are not supported.Inputs of type
'char'
are not supported.
For more information, seeTall Arrays.
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Usage notes and limitations:
Code generation does not support cell arrays for the first or second arguments.
Code generation does not support
setxor
适应行之间nd columns.A
andB
must be variable-size vector inputs with the same orientation.When you do not specify the
'rows'
option:Inputs
A
andB
must be vectors with the same orientation. If you specify the'legacy'
option, then inputsA
andB
must be row vectors.The first dimension of a variable-size row vector must have fixed length 1. The second dimension of a variable-size column vector must have fixed length 1.
The input
[]
is not supported. Use a 1-by-0 or 0-by-1 input, for example ,zeros(1,0)
, to represent the empty set.If you specify the
'legacy'
option, then empty outputs are row vectors, 1-by-0, never 0-by-0.
When you specify both the
'legacy'
option and the'rows'
option, the outputsia
andib
are column vectors. If these outputs are empty, then they are 0-by-1. They are never 0-by-0, even if the outputC
is 0-by-0.When the
setOrder
is not'stable'
or when you specify the'legacy'
flag, the inputs must already be sorted in ascending order. The first output,C
, is sorted in ascending order.Complex inputs must be
single
ordouble
.When one input is complex and the other input is real, do one of the following:
Set
setOrder
to'stable'
.Sort the real input in complex ascending order (by absolute value). Suppose the real input is
x
. Usesort(complex(x))
orsortrows(complex(x))
.
SeeCode Generation for Complex Data with Zero-Valued Imaginary Parts(MATLAB Coder).
GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.
Usage notes and limitations:
The
'legacy'
flag is not supported.64-bit integers are not supported.
For more information, seeRun MATLAB Functions on a GPU(Parallel Computing Toolbox).
Open Example
A modified version of this example exists on your system. Do you want to open this version instead?
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select:.
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina(Español)
- Canada(English)
- United States(English)
Europe
- Belgium(English)
- Denmark(English)
- Deutschland(Deutsch)
- 西班牙(Español)
- Finland(English)
- France(Français)
- Ireland(English)
- Italia(Italiano)
- Luxembourg(English)
- Netherlands(English)
- Norway(English)
- Österreich(Deutsch)
- Portugal(English)
- Sweden(English)
- Switzerland
- United Kingdom(English)