Contents, cont'd. - Intermec

LOC
Chapter 2 Program Instructions
Field of Application Function returning the current position in an OPENed file or the status
of the buffers in an OPENed communication channel.
Syntax LOC()
is the number assigned to the file or communication channel
when it was OPENed.
Remarks In a random file, LOC will return the number of the last record read or written
by the use of GET or PUT statements respectively.
In a sequential file, the number of 128-byte blocks, that have been read or
written since the file was OPENed, will be returned.
LOC can also be used to check the receiver or transmitter buffer of the
specified communication channel:
• If the channel is OPENed for INPUT, the remaining number of characters
(bytes) to be read from the receiver buffer is returned.
• If the channel is OPENed for OUTPUT, the remaining free space (bytes)
in the transmitter buffer is returned.
The number of bytes includes characters that will be MAPped as NULL.
Examples This example closes the file "addresses" when record No. 100 has been read
from the file:
10 OPEN "ADDRESSES" FOR INPUT AS #1
.....
.....
.....
200 IF LOC(1)=100 THEN CLOSE #1
.....
.....
This example reads the number of bytes which remains to be received from
the receiver buffer of "uart2:":
100 OPEN "uart2:" FOR INPUT AS #2
110 A%=LOC(2)
120 PRINT A%
Intermec Fingerprint 7.2 – Reference Manual Ed. 3 139