SELECT
Purpose
Used to set system parameters indicating that a select list is active. This information is used by subsequent READNEXT logic.
Arguments
| Argument | Input/Output | Value |
|---|---|---|
| CODE | Input | 7 |
| Output | unchanged | |
| BFS | Input | BFS List |
| Output | unchanged | |
| HANDLE | Input | File Handle |
| Output | unchanged | |
| NAME | Input | Extended selects pass first sort field, otherwise null |
| Output | unchanged | |
| FMC | Input | null |
| Output | Latent index sorts return first sort field, otherwise FMC contains the select pointer | |
| RECORD | Input | 0 |
| Output | Select mode | |
| STATUS | Input | null |
| Output | Returns 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