The record number to retrieve.
Goto a specific record number in the table, returns positive if record found, else negitive record number.
The <TBL>.FETCH_GOTO() method fetches the specified Record_Number from the table or set referenced by <TBL>. If the record number is found in the table, Found_Record_Number equals the Record_Number. If the record number is not found, the method returns an error. The <TBL>.FETCH_GOTO() method can be used regardless of whether an index or query list is active, or record number is the primary index. The <TBL>.FETCH_GOTO() method can be used to point to deleted records (prior to packing the table). Using this technique, you can "undelete" records. (Of course, you could also use the <TBL>.UNDELETE() method.)
This script sets the primary index to Lastname, then goes to record 5. Since the primary index is Lastname, <TBL>.FETCH_FIND() can only be used to find by Lastname. So to go to record 5, without changing the index to record number order, FETCH_GOTO()is used.
dim tbl as P tbl = table.open("customer") indx_lastname = tbl.index_primary_put("Lastname") tbl.fetch_goto(5)
This script un-deletes record 10.
dim tbl as P tbl = table.open("customer") tbl.fetch_goto(10) tbl.change_begin() tbl.deleted = "" tbl.change_end(.T.)