# $EPIC: getitem.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $
======Synopsis:======
$__getitem__(<array> <item#>) \\ 
$__igetitem__(<array> <index#>)

======Technical:======
These functions are used to fetch data held in the given array.

The $__getitem__() function retrieves data based on its item number in
the array (counting from zero, the order in which the data was entered).

The $__igetitem__() function retrieves it based on its index number
(counting from zero, in a sorted order).

These functions only affect arrays created with $[[setitem]]().

======Practical:======
These functions are used to get an item in an array.  The applications
for these function should be obvious.  The $__igetitem__() function, in
particular, is useful for showing an array's contents in alphabetical
order.

======Returns:======
array item data, or empty string if array or item is not found