Table of Contents

SELECT

Purpose

Used to set system parameters indicating that a select list is active. This information is used by subsequent READNEXT logic.

Arguments

ArgumentInput/OutputValue
CODEInput7
Outputunchanged
BFSInputBFS List
Outputunchanged
HANDLEInputFile Handle
Outputunchanged
NAMEInputExtended selects pass first sort field, otherwise null
Outputunchanged
FMCInputnull
OutputLatent index sorts return first sort field, otherwise FMC contains the select pointer
RECORDInput0
OutputSelect mode
STATUSInputnull
OutputReturns true for non-index-based selects if the select initialization was successful. Returns null for latent index selects.

Note

Latent index selects, and argument values associated with these, are a function of SI.MFS, and not of the underlying BFS. For instance, the select mode value of 2 returned in the RECORD argument returns from SI.MFS. To disable a SELECT (cause subsequent READNEXT operations to fall through ELSE branch), RECORD should be set to false.

Called by

BASIC+ SELECT statement