# $EPIC: getmatches.txt,v 1.3 2007/02/27 04:57:37 jnelson Exp $
======Synopsis:======
$__getmatches__(<array> <pattern>)

======Technical:======
This function treats the items in array as literal strings, and returns
a word list of item values such that

	for i in ($getrmatches(<array> <string>)) {
		if (getitem(<array> $i) =~ <pattern>) {
			echo True
		} else {
			echo False
		}
	}

only outputs True and enver False.  This is the reverse of [[getrmatches]].

======Practical:======
The $__getmatches__() function is used to retrieve all items in the given
array that match the given pattern.  Similarly, $__getrmatches__() is used
to retrieve all items that match the given string.

======Returns:======
list of item numbers corresponding to matches