# $EPIC: getrmatches.txt,v 1.2 2007/02/27 04:57:37 jnelson Exp $
======Synopsis:======
$__getrmatches__(<array> <string>)

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

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

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

======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