RxHash

Name     RxHash - Associative Arrays for REXX 
Version  Version 1.0.0, 26 May 2003 
Author   Patrick TJ McPhee 
         (see EMail Addresses)
Distrib. Freeware 
Type     REXX DLL 
Price    -
Note     w/ source 
Source   Internet 
         Name: rxhash100.* 

Description from the author: 

"Associative arrays are indexed data structures which use arbitrary data 
as keys. Where a `normal' array idenifies a value by its location in the 
array structure, associative arrays associate values with their keys, 
which are often useful application-specific data in themselves. This 
concept is widely used in scripting applications; for instance, Rexx's 
stem variables are a form of associative array. 

While they are a form of associative array, stem variables in ANSI Rexx 
don't provide two useful features: an operation to enumerate the keys in 
use in the array, and operations which act on the array as a whole, 
especially copying and passing to a function. The RxHash package is a set 
of routines for manipulating associative arrays which can be copied and 
passed as function arguments. It includes functions to convert between 
RxHash arrays and stem variables, and C language functions which can be 
used by other Rexx loadable libraries to generate and modify RxHash 
arrays." 

The DLL exports the following functions: 

 ArrLoadFuncs() 
     Register the functions from the DLL 

 ArrDropFuncs() 
     Unload the DLL 

 ArrVersion() 
     returns the version number of the library 

 ArrNew( [default] ) 
     Allocate memory for an array and return a pointer to it 

 ArrDefault( arr, value ) 
     sets the default value wich is returned by ArrGet() if the key 
    argument is not in the array 

 ArrSet( arr, key, value ) 
     associates a value with a key in an array. 

 ArrGet( arr, key ) 
     looks up a key in an array and returns its value 

 ArrIn( arr, key[, key2, ...] ) 
     returns 1 if all the specified keys are stored in the array 

 ArrDoOver( arr [, reset] ) 
     return the next key value from the array 

 newArr = ArrCopy( arr ) 
     Make a copy of the array a 

 ArrDrop( arr [,key, ...] ) 
      Either remove one or more key values from the array or remove all 
    values from arr and free the array memory 

 ArrToStem( arr, stemname ) 
     drop the stem and, then, for each element of the array, sets the 
    corresponding tail of stemname. 

 arr = ArrFromStem( stemname ) 
     Returns a new array which is populated with all the data from the 
    stem