ISRCHMNE (3sciport)

Searches a vector for the first element whose subfield does not match a target

SYNOPSIS

  location = ISRCHMNE( n, x, incx, target, mask, right )

FUNCTION VALUE

  isrchmne        Integer.
                  The location of the first term in vector x whose subfield
                  does not match target.

ARGUMENTS

  n               Integer.
                  The number of elements to be searched.  If n <= 0, then 0
                  is returned.

  x               Integer, Logical, or Real vector.
                  An input vector of length n.

  incx            Integer.
                  The increment between elements of the search vector. For
                  contiguous elements, incx = 1.

  target          Integer.
                  The subfield comparison value.

  mask            Integer.  A right justified bit mask used to extract bit
                  subfields from elements of vector x.

  right           Integer.  The number of bits to right shift an element of
                  vector x before it is boolean .AND.'d with mask and
                  compared to target.

DESCRIPTION

  The function ISRCHMEQ returns the first location in vector x where an
  element that has been right shifted right bits and then boolean .AND.'d
  with mask does not match the target value. If target is always found, the
  returned value is n+1.

  For equations and other information, see Volume 3: UNICOS Math and
  Scientific Library Reference Manual SR-2081 7.0, Cray Research, Inc.