Site Tools


corfilter
no way to compare when less than two revisions

Differences

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


corfilter [2007/03/02 02:32] (current) – created - external edit 127.0.0.1
Line 1: Line 1:
 +# $EPIC: corfilter.txt,v 1.3 2007/03/02 02:32:04 jnelson Exp $
 +======Synopsis:======
 +$[[corfilter]](<string> <var1> <var2>)
 +
 +======Description:======
 +The <string> argument is a [[what is a word|dword]], which is different
 +than most functions.
 +
 +This function is the reverse operation of [[cofilter]], and the 
 +complementary operation of [[corpattern]].
 +
 +This function is closely related to [[rfilter]], which returns all of the
 +wildcard patterns in a word list that do not match a literal string.
 +
 +All of the cor* functions take a literal string, and two variable names.
 +The first variable should contain a word list of wildcard patterns, and 
 +the second variable should contain a word list.  The string is matched
 +against each of the patterns in the first list, and depending on the result,
 +the corresponding word in the second list is included or excluded in the
 +resturn value.
 +
 +The [[corfilter]] function returns all those words in $<var2> that 
 +correspond in position to those patterns in $<var1> that do not
 +match the <string>.
 +
 +Parsing ends whenever the shorter of the two word lists runs out of words.
 +Therefore, the two word lists should have the same number of words.
 +
 +The literal <string> may be optionally surrounded by double quotes,
 +if the word contains spaces.  The double quotes are not considered part
 +of the string for the purposes of matching.
 +
 +======Returns:======
 +The words from $<var2> that correspond to all of the words in $<var1> 
 +that are not matched by <pattern>.
 +
 +======Examples:======
 +<file>
 +@ friends = [ooga!bob@*.foo.com *!tom@*.com]
 +@ levels  = [20 10]
 +$corfilter(ooga!bob@lace.foo.com friends levels)       returns "10"
 +$corfilter(hype!tom@bar.com friends levels)            returns "20"
 +</file>
  
corfilter.txt · Last modified: 2007/03/02 02:32 by 127.0.0.1