User guide

40 CHAPTER 3. THE LIBRARY
rtn
vecstatsv CIN:y, POS:y, NAT:n
This points to a vector holding counts of how many blocks of each requested size
have been allocated by getvec but not yet returned. It is used by the vecstats
command.
rtn vecstatsvupb CIN:y, POS:y, NAT:n
This field hold the upper bound of vecstatsv.
saveregs CIN:n, POS:y, NAT:n
This is the location in Cintcode memory used in Cintpos to hold the Cintcode
registers at the time of the most recent interrupt.
scb
. . . CIN:y, POS:y, NAT:n
Each currently open stream has a stream control block (SCB) that holds all that
the system needs to know about the stream. Manifest constants beginning scb
allow
convenient access to the SCB fields. These are described below.
scb
blength CIN:y, POS:y, NAT:n
This SCB field hold the length of the buffer in bytes. It is typic al l y 4096.
scb
block CIN:y, POS:y, NAT:n
This SCB field holds the current block number of a disc file. The first block of a
file has number zero.
scb
buf CIN:y, POS:y, NAT:n
This SCB field is either zero or points the the buffer of bytes, allocated by getvec,
associated with the stream.
scb
bufend CIN:y, POS:y, NAT:n
This SCB field holds the size of the buffer in bytes.
scb
encoding CIN:y, POS:y, NAT:n
This SCB field controls how codewrch treats extended characters written to this
stream. If its value is GB2312, the extended character is translated into one or two
bytes in GB2312 format, ot he r wi se the translation is to a sequence of bytes in UTF-8
format. This field is normally se t using either codewrch(UTF8) or codewrch(GB2312).
scb
end CIN:y, POS:y, NAT:n
This SCB field hold the number of valid by t e s in the buffer or -1, if the stream is
exhausted.
scb
endfn CIN:y, POS:y, NAT:n
This SCB field is either zero or the function to close down the stream. It is given
the SCB as its argument and returns TRUE if it successfully outputs the contents of the
buffer. It otherwise retu rn s FALSE with an error code in result2.
scb fd CIN:y, POS:y, NAT:n
This SCB field holds a machine dependent file or mailbox descriptor.