Included in this archive are routines that will allow you to use variables just
as you would files. Although string manipulation is fairly comprehensive in
ARexx, it can be difficult to perform some functions. After reading a moderately
long file (up to 65535 characters) into a variable, these VIO routines will
allow you to:

  * Move a "pointer" forward or backwards through the variable-file
  * Read a series of line-feed-terminated lines from the variable-file, starting at the pointer location
  * Use string manipulation functions (eg, Insert(), DelStr(), and Translate()) on the variable-file (not possible with a true file)

The function calls and returns mirror their file manipulation counterparts,
while the arguments often offer enhancements over the file manipulation routines:

  * "Open" a variable for manipulation
  * "Close" the variable
  * Reposition the variable's "pointer"
  * Read the next character(s) from the variable
  * Read the next LF-terminated line(s) from the variable
  * Write the specified character(s) to the variable
  * Write a LF-terminated line to the variable
  * Determine when the end of the variable is reached

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 3212   12237  26.2% -lh5- 8e69 Jun 26  2000 VIO.guide
[generic]                 1010    4178  24.2% -lh5- 419a Jun 26  2000 VIO.rexx
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         2 files    4222   16415  25.7%            Jun 28  2000