BTree++ Programming Library / List of Commands / "Q" Get Next Record #

FATS - Fast Access Tree System
	Table of Contents
		List of Commands
			"Q" Get Next Record #

"Q" Get Next Record #

Command string:

CMND$ = "Q\{FileNo}"

FileNo File number

Purpose:

Get the record number that will be assigned on the next insert command.

Description:

The record numbers of deleted data records are taken up by FATS with the command

Delete Record (D) to a list of the data records that already have been deleted, so that the command

Insert Record (I) can possibly reuse these, before the data file must be extended. This list is administered according to the principle last in, first out, i.e. the record deleted last is reused as next.

If there are no entries in the list this command will return the number of the next available record in the data file. If there are entries in the list, the record number of the last deleted record will be returned.

Parameters returned:

ERRORCODE:	Errorcode or 0 (no error)
RECNO:	Record number
FATSKEY:	Undefined

Example:

CMND$ = "Q\1"

See also:

"D" Delete Record; page 4-21

"I" Insert Record; page 4-38