# $EPIC: delitem,v 1.2 2001/06/22 20:01:37 jnelson Exp $
Synopsis:
   $delitem(<array> <item#>)

Technical:
   This function is used to delete an entry from an array created with
   $setitem().  If the item deleted is the only one present in the array,
   the array is deleted too.  If the item is not the last item in the
   array, all items beyond it (with higher item numbers) are shifted down
   by one to fill in the gap.

Practical:
   This function is used to delete items from an array.  The uses for this
   are pretty obvious.  If you add items to an array, it follows that you
   might want to remove them, too.

Returns:
   -2   if the item does not exist in the array
   -1   if the array does not exist
    0   on success

Examples:
   $delitem(array 2)             deletes item 2 from array "array"
   $delitem(fake_array 4)        error, "fake_array_ does not exist
   $delitem(array -2)            error, item -2 does not exist

See Also:
   Arrays(7); getitem(6); setitem(6)

