Function Found() Foundation
Determines whether the last search operation was successful.
Found() --> lSuccess
The return value of Found() is .T. (true) when the last search operation executed in a work area was successful. When a search operation has failed or when no file is open in the specified work area, Found() returns the value .F.(false).
The database function Found() indicates whether the last search operation in a work area was successful. When the function is used without the alias operator, it returns the success of the last search operation in the current work area. Search operations are explicitly executed using the function DbSeek() and implicitly (automatically) occur when a relation is defined between two or more work areas using DbSetRelation() or the command SET RELATION TO. Other search operations are performed using DbLocate() and DbContinue().
Search operations seek a value in a work area. When the search value is found in the work area, Found() returns the value .T. (true). Otherwise it returns the value .F. (false). This value is returned by the function until the record pointer in the work area is moved. Each work area has its own Found() status. As soon as the record pointer is moved, the Found() status in the work area is set to the value .F. (false).
The functions DbLocate() and DbContinue() test a condition for each data record in a work area. The search actually occurs in the database file of the work area and Found() then returns .T. (true) when the search condition matches the current record. All other search commands and functions execute a search in the controlling index for the specified value. If the search value is found in the index, Found() returns .T. (true). Otherwise it returns .F. (false).
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.