User Tools

Site Tools


igetitem

Differences

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

Link to this comparison view

igetitem [2007/02/27 04:57] (current)
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).
 +
  
igetitem.txt ยท Last modified: 2007/02/27 04:57 (external edit)