Short:        Manipulate variables as you would files
Author:       Ron Goertz
Uploader:     goertz earthlink net
Type:         util/rexx
Replaces:     util/rexx/VIO*
Architecture: m68k-amigaos

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