Site Tools


rfilter

# $EPIC: rfilter.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $

Synopsis:

$rfilter(<word> <pattern list>)

Technical:

  • If the <word> argument is omitted the empty string is returned.
  • This function returns a space separated pattern list of all of the patterns in <pattern list> that DO NOT match <word>.
  • This is the complement to $rpattern(), and the inverse of $filter().
  • Double quoted words are honored, but the double quotes will be lost in the return value.

Practical:

This function lets you “filter” <pattern list> through a word, keeping all of the patterns that do not match a given word, and discarding all of the patterns that do match the given word.

If you have a list of patterns, some of which match a word (say, a nick!user@host string) and some of which don't, and you want to remove the ones that do, this function will do that.

Returns:

The list of patterns from <pattern list> that do not match <word>.

History:

This function first appeared in “plus-2” (post-ircII, pre-EPIC)

Examples:

$rfilter(foobar f* *oo* a* *c)    returns "a* *c"
$rfilter(hello hello a* *lo*)     returns "a*"
rfilter.txt · Last modified: 2006/08/29 16:08 by 127.0.0.1