SPFLite - V3.0.24069 2024-03-09

str-var = Get_Trk_Pos$(index-number)

Operands:

index-number

The index-number indicates which Track position is desired, where: (1) indicates the latest, (2) indicates the prior entry, (3) the next previous, etc.   If the index number is not specified, the default is (1).

Returns:

The answer returned is a simple comma delimited String of the format  

TOS-Line,Csr_LPtr,CSR_Coll 

Where:        

TOS-Line        The Lptr of the Top-of-Screen line in character format.

Csr_LPtr        The Lptr of the line containing the cursor in character format. If this value is zero, it indicates the cursor was on the command line.

Csr_Col        The location of the cursor within the text line in character format. If zero it indicates the cursor was in the Line-number area.

The Return-code should be checked before using the return value, since errors are possible. Currently the two error conditions are:

• The index-number references a Stack entry which has never been used.
• The Stack entry has been used, but now references a Top-of-Screen line which no longer exists (i.e. it has been deleted)