Visible to Intel only — GUID: GUID-B2B894FB-D5D0-4CF5-AE50-0ABE5CE1FD79
Visible to Intel only — GUID: GUID-B2B894FB-D5D0-4CF5-AE50-0ABE5CE1FD79
IPARITY
Transformational Intrinsic Function (Generic): Returns the result of a bitwise exclusive OR operation.
result = IPARITY (array, dim [, mask])
result = IPARITY (array [, mask])
array |
(Input) Must be an array of type integer. |
dim |
(Input) Must be a scalar integer with a value in the range 1 <= dim <= n, where n is the rank of array. |
mask |
(Input; optional) Must be of type logical and conformable with array. |
Results
The result has the same type and kind parameters as array. It is scalar if dim does not appear; otherwise, the result has rank n - 1 and shape [d1, d2, ..., ddim-1, ddim+1 , ..., dn] where [d1, d2,..., dn] is the shape of array.
The result of IPARITY (array) has a value equal to the bitwise exclusive OR of all the elements of array. If array has size zero, the result value is equal to zero.
The result of IPARITY (array, MASK=mask) has a value equal to IPARITY (PACK (array, mask)).
The result of IPARITY (array, DIM=dim [ , MASK=mask]) has a value equal to that of IPARITY (array [ , MASK=mask]) if array has rank one. Otherwise, the value of element (s1, s2, ..., sdim-1, sdim+1 , ..., sn) of the result is equal to IPARITY (array (s1, s2, ..., sdim-1 , :, sdim+1 , ..., sn) [, MASK = mask (s1, s2, ..., sdim-1 , :, sdim+1 , ..., sn)]).
Example
IPARITY ([14, 13, 8]) has the value 11. IPARITY ([14, 13, 8], MASK=[.true., .false., .true]) has the value 6.