Copying the key values of the next selected table record¶
table_next_selected_key() |
Copy key values of next selected record |
SYNTAX
table_next_selected_key(table_id)
This function is for use with tables whose source object is a file and which have the edit mode flag EM_MULTIPLE assigned. This flag enables multiple selections to be made from the table.
After table_first_selected_key() has been called, each subsequent call to table_next_selected_key() places the key values of the next selected record in the file’s record buffer. If the source object is a secondary index, the values copied are the main index key, not the secondary index key.
The program can then read the record from the file using read[u], or use the key values for any other purpose.
Returns zero (OKAY) if there is another selected record.
Returns a non-zero value if there are no more selected records, or if the table source object is not a file. In this case they key fields in the file’s record buffer remain unchanged.
RELATED TOPICS |