ISRCHMGE (3sciport)

Searches a vector for the first element whose subfield is greater than or equal to a target

SYNOPSIS

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

FUNCTION VALUE

  isrchmge        Integer.
                  The location of the first term in vector x whose subfield
                  is greater than or equal to 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 ISRCHMGE returns the first location in vector x where an
  element that has been right shifted right bits and then boolean .AND.'d
  with mask is greater than or equal to the target value. If target is always
  greater than the extracted subfield, 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.