ISRCHMEQ (3sciport)

Searches a vector for the first element whose subfield matches a target

SYNOPSIS

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

FUNCTION VALUE

  isrchmeq        Integer.
                  The location of the first term in vector x whose subfield
                  matches 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 matches the target value. If target is not 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.