User guide

4.3. COMMANDS 127
vecstats CIN:y, POS:y, NAT:y
This command output information about blocks of Cintcode memory that are cur-
rently allocated. Typical output (from Cintpos) is the fol l owing:
3: 12 4: 2 6: 1 15: 2 22: 1 23: 7
27: 4 28: 1 41: 1 80: 1 200: 2 291: 1
306: 2 316: 1 406: 1 462: 1 500: 1 506: 3
571: 1 597: 1 757: 1 982: 1 1000: 10 1006: 6
1025: 2 1901: 1 2422: 1 3303: 1 20000: 1
This indicates, for instance, that there are currently 7 blocks of requested size 23
allocated.
wait N/N,SEC=SECS/S,MIN=MINS/S,UNTIL/K CIN:y, POS:y, NAT:y
This causes the CLI to wait for a specified number of seconds or minutes, or until
a specified time is reached.
why CIN:y, POS:y, NAT:y
This command attempts to give the reason why the previous command failed. For
fun you can type why several times.
x8-bin FROM/A,TO/K CIN:y, POS:y, NAT:y
This converts a file of 32-bit words in hex into a file of the corresponding bytes.
For instance, it will convert the file:
44434241 48474645 4C4B4A49 504F4E4D 54535251 58575655 310A5A59 35343332
39383736 00000A30
to
ABCDEFGHIJKLMNOPQRSTUVWXYZ
1234567890
xcmpltest CIN:y, POS:y, NAT:y
This is a test program that checks for errors in the XBCPL compiler and extended
features in the Cintcode interpreter.
xcdecode FROM/A,LIST/S,BIN/S CIN:y, POS:y, NAT:y
This command is the inverse of xcencode. With the LIST option it will inspect
the FROM file list i ng the names of the files it contains. Without the LIST option it will
extract and decode these files. If BIN is set, files are written using binwrch so that
carriage return characters (’*c’) are not ignored. All characters before the first file
separator are ignored.
xcencode FILE,LIST/K,TO/K/A,BIN/S CIN:y, POS:y, NAT:y
This comm and is designed to encode one or more files in such a way that they
can be passed as the body of an emai l message wi th out interferring with the email
mechanism. It uses a simple form of run length encoding to reduce the size of the