View source for BitXOr

[[category:Bit functions]]

''new in [[Analytica 4.7]]''

== BitXOr( x'', I'' ) ==

Returns the bitwise exclusive-OR (XOR) of the integer portions of an array of numbers. Each bit in the result is on only if the corresponding bit is on in an odd number of integers in «x» along index «<code>I</code>».  «<code>I</code>» can be omitted when taking the bitwise XOR across the [[Implicit dimension]].

Each integer may have up to 64 bits.

== Examples ==

To find the bitwise XOR of three numbers, the numbers can be listed in brackets (the implicit index) and the index parameter omitted.
:<code>[[BitXOr]]( [23, 29, 25] )</code> &rarr; 19
This is more obvious when we write these same numbers in [[Binary and hexadecimal integer formats|binary notation]]:
:<code>[[BitXOr]]( [0b10111, 0b11101, 0b11001] )</code> &rarr; 19  { note: 17 = 0b10011 }

Suppose x is the following 2-D array of integers
:[[image:BitAnd_x.png]]
which is shown here in [[Binary and hexadecimal integer formats|binary notation]]
:[[image:binary_x_BitAnd.png]]
then
:<code>[[BitXOr]](x,I)</code> &rarr; [[image:BitXOr_result1d.png]] 
:::= [[image:BitXOr_result1.png]]
:<code>[[BitXOr]](x,J)</code> &rarr; [[image:BitXOr_result2.png]]

== See Also ==
* [[BitAnd]], [[BitOr]], [[BitNot]]
* [[BitCount]], [[BitShift]]