table.FETCH_FIRST Function
Syntax
Arguments
- Found_Flag
0 if a record was found. A negative number if no record was found.
- level
Optional. Used when fetching through the records of a set. The outline level determines the depth of the fetch, so that tables at lower levels in the set can be excluded from the Fetch operation.
Description
Fetch the first record in the table/set. returns TRUE if record found.
Discussion
The <TBL>.FETCH_FIRST() method retrieves the first record in the table or set referenced by <TBL>. The first record is determined by the active range, index, or query list. If there are no records in the current range or query, and therefore, no first record is found, a non-zero numeric value is returned. You use the optional Level_Number parameter when fetching through the records of a set. The outline level determines the depth of the fetch, so that tables at lower levels in the set can be excluded from the Fetch operation. This is useful for operations that relate to only parent records in a set. For more information, see Fetching_Only_Parent_Records_With_Fetch_Outlining.
Example
This script will open a table and fetch the first record.
dim tbl as P tbl = table.open("c:\a5\a_sports\customer.dbf") tbl.fetch_first()
This script which is attached to a button on a form will display the first record in the form.
dim tbl as P tbl = table.current() tbl.fetch_first() parent.resynch()
This script also displays the first record on the form, but it uses a form method instead
parent.fetch_first()
See Also