Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+# $EPIC: igetitem.txt,v 1.2 2007/02/27 04:57:37 jnelson Exp $
+======Synopsis:======
+$__igetitem__(<array> <index#>)
+======Technical:======
+This function fetches a data item in the given array based on the index
+number.  The index number is the position of the item based on its
+sorted-order.  Remember that array items sort case-sensitive.  Index 0
+is the first item, in sorted order, whereas ${numitems(<array>)-1} is
+the last item, in sorted order.
+Normally this operation is instantaneous, because arrays are always kept
+sorted.  But if you use [[delitems]] or [[usetitem]], the array can become
+unsorted, and is resorted the next time you fetch an item.
+======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
+======History:======
+This function first appeared in "plus 3" (post-ircII, pre-EPIC).

EPIC