CAT_SFND$<$t$>$ - Create a selection of rows within a given range

Description:

Create a selection of rows in a catalogue for which the fields for a specified column lie in a given range.

A field is selected if it lies in the range:

field value .GE. MINRNG .AND. field value .LE. MAXRNG

The selection may be created from either a genuine catalogue or some previous selection from a catalogue.

The specified column must be sorted in ascending or descending order (eventually the routine will be enhanced to work on indexed columns too).

Invocation:

CALL CAT_SFND$<$t$>$ (CI, FI, MINRNG, MAXRNG, REJFLG; SI, NUMSEL, SIR, NUMREJ; STATUS)

Arguments:

CI = INTEGER (Given)

Input catalogue or selection from which the new selection is to be generated. Note that CI may be either a catalogue or a selection identifier.

FI = INTEGER (Given)

Identifier to the column whose fields will be selected to lie in the given range. The column must be sorted into ascending or descending order (and known by CAT to be so sorted).

MINRNG = $<$type$>$ (Given)

Minimum value which a field must satisfy to be selected.

MAXRNG = $<$type$>$ (Given)

Maximum value which a field must satisfy to be selected.

REJFLG = LOGICAL (Returned)

Flag indicating whether or not a second selection of the rejected rows is to be created: .TRUE. - create the catalogue of rejected rows, .FALSE. - do not create the catalogue of rejected rows.

SI = INTEGER (Returned)

Selection identifier to the set of selected rows.

NUMSEL = INTEGER (Returned)

Number of rows selected.

SIR = INTEGER (Returned)

Optional selection identifier to the set of rejected rows. If the rejected rows are not being retained then SIR is set to the null identifier.

NUMREJ = INTEGER (Returned)

Number of rows rejected.

STATUS = INTEGER (Given and Returned)

The global status.

Copyright

Copyright (C) 1999 Central Laboratory of the Research Councils

Bugs:

None known