Differences

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

@@ Line 1: / Line 1: @@
+# $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:======
+<file>
+$rfilter(foobar f* *oo* a* *c)    returns "a* *c"
+$rfilter(hello hello a* *lo*)     returns "a*"
+</file>

EPIC