9.188 SELECTNEXT_IN_SPACE
Note: Built-In Function Rules Usage Options
Selects the next row of cells that matches the key values supplied and returns the cell values into the specified fields.
Arguments
|
Return Values
|
Technical Notes
The return fields must be specified in the same order as the cells in the space were defined. Cells are matched by the order of their specification in return values 2 -> 20. The names of the fields used have no bearing whatsoever on the cell mapping logic.
You can specify less key values than are defined in the space. The first matching cell row will be returned. This means that partial key operations can be performed.
If you specify more key values than are defined as key cells for the space then the additional values will be ignored and have no effect on the outcome of the search.
If you specify less return field values than there are cells in the space then the non-specified cells are not mapped back into the fields.
If you specify more return field values than there are cells in the space then the additional field values are ignored and are not changed by the search operation.
If a key value longer than 256 bytes is specified, a fatal error will occur.
Using a SELECTNEXT_IN_SPACE operation that is not immediately preceded by a SELECT_IN_SPACE or a SELECTNEXT_IN_SPACE operation may produce unpredictable results and/or application failure.