[ HPF Home | Versions | Compilers | Projects | Publications | Applications | Benchmarks | Events | Contact ]



Next:
IPARITY_PREFIX(ARRAYDIM, MASK, Up: Specifications of Library Previous: IANY_SUFFIX(ARRAYDIM, MASK,

IPARITY(ARRAY, DIM, MASK)

Optional Arguments. DIM, MASK
Description. Computes a bitwise logical exclusive OR reduction along dimension DIM of ARRAY.
Class. Transformational function.
Arguments.

ARRAY must be of type integer. It must not be scalar.

DIM (optional) must be scalar and of type integer with a value in the range , where is the rank of ARRAY. The corresponding actual argument must not be an optional dummy argument.

MASK (optional) must be of type logical and must be conformable with ARRAY.
Result Type, Type Parameter, and Shape. The result is of type integer with the same kind type parameter as ARRAY. It is scalar if DIM is absent or if ARRAY has rank one; otherwise, the result is an array of rank and shape where is the shape of ARRAY.
Result Value.
*

(i): The result of IPARITY(ARRAY) is the IEOR reduction of all the elements of ARRAY. If ARRAY has size zero, the result has the value zero. See Section .

(ii): The result of IPARITY(ARRAY, MASK=MASK) is the IEOR reduction of all the elements of ARRAY corresponding to the true elements of MASK; if MASK contains no true elements, the result is zero.

(iii): If ARRAY has rank one, IPARITY(ARRAY, DIM [,MASK]) has a value equal to that of IPARITY(ARRAY [,MASK]). Otherwise, the value of element of IPARITY(ARRAY, DIM [,MASK]) is equal to IPARITY(ARRAY() [,MASK = MASK()])
Examples.
*

(i): The value of IPARITY((/13, 8, 3, 2/)) is 4. (ii): The value of IPARITY(C, MASK = BTEST(C,0)) is the IEOR reduction of the odd elements of C.

(iii): If B is the array , 2 3 7 0 4 2 ,, plus 1filll -1; 2 3 7 0 4 2 ,; plus 1filll -1: 2 3 7 0 4 2 ,: plus 1filll -1.plus 1filll 2 3 7 0 4 2 ,.-50 2 3 7 0 4 2 , plus 1filll-1, then IPARITY(B, DIM = 1) is ,2, 7, 5,, plus 1filll -1;2, 7, 5,; plus 1filll -1:2, 7, 5,: plus 1filll -1.2, 7, 5,. plus 1filll -12, 7, 5, plus 1filll-1 and IPARITY(B, DIM = 2) is ,6, 6,, plus 1filll -1;6, 6,; plus 1filll -1:6, 6,: plus 1filll -1.6, 6,. plus 1filll -16, 6, plus 1filll-1.




Next:
IPARITY_PREFIX(ARRAYDIM, MASK, Up: Specifications of Library Previous: IANY_SUFFIX(ARRAYDIM, MASK,



©2000-2006 Rice University [ Contact Us | HiPerSoft | Computer Science ]

paula@erc.msstate.edu
Thu Dec 8 16:17:11 CST 1994