READ_PREVIOUS_MULTI
|
Syntax: |
READ_PREVIOUS_MULTI(<Name of Index
File>, <Key Number>, <Array>, <Count>)
|
||||||||||
|
Meaning: |
READ_PREVIOUS_MULTI reads several data
records from an Ebus Index File and stores the data records in the
<Array>. The number of data records to read is specified by
<Count>. <Key Number> specifies the key by which
the data records are read. 0 specifies the primary key, 1,..,n specify a
secondary key. <Array> must be the name of an
one-dimensional String Array which contains at least <Count> elements. <Name of Index File> must be an Ebus
Index File. READ_PREVIOUS_MULTI executes several
instructions READ-PREVIOUS or READS-PREVIOUS. The <Array>
is filled with RECORD$(<Name of Index File>) starting with element No. 1. If less than
<Count> data records are found only the found data records are stored
in <Array>. READ_PREVIOUS_MULTI returns the number of read data
records. READ_PREVIOUS_MULTI is only successful if the
file pointer is set properly by a valid START, READ, READ-NEXT oder
READ-PREVIOUS instruction with the same key. READ_PREVIOUS_MULTI returns the following
results:
|
||||||||||
|
Parameter: |
|
||||||||||
|
Sample: |
DIM T$(10) CUSTOMER.NUMBER =
9999999 START CUSTOMER ON
ERROR END NUMBER% = READ_PREVIOUS_MULTI(CUSTOMER,0,T$,10) IF NUMBER% < 1 RECORD(CUSTOMER) = T$(I%) |
||||||||||
|
See also: |
|