This shows you the differences between two versions of the page.
— |
common [2006/07/25 21:22] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | # $EPIC: common.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ | ||
+ | ======Synopsis:====== | ||
+ | $__common__(<word list 1> / <word list 2>) | ||
+ | |||
+ | ======Technical:====== | ||
+ | * There must be a literal slash character ('/') that separates the two word lists. If it is omitted the empty string is returned. | ||
+ | * It is not required to have spaces on either side of the slash, but it also does not hurt to have them. | ||
+ | * The return value is a word list comprised of the set-intersection of <word list 1> and <word list 2>, that is to say: | ||
+ | * The return value is a word list of all words that are in BOTH of the word lists. | ||
+ | * All extra whitespace around words will be lost. | ||
+ | * Double quoted words are honored, but the double quotes will be lost in the return value. | ||
+ | |||
+ | ======Practical:====== | ||
+ | Use this function if you need to find the intersection of two different | ||
+ | word lists. A useful example might if you wanted to find out all of the | ||
+ | people who are on two different channels. If you have the nick lists to | ||
+ | those two channels, you can use $common() to find all the people on both | ||
+ | channels. | ||
+ | |||
+ | ======Returns:====== | ||
+ | All words that are in both <word list 1> and <word list 2>. | ||
+ | |||
+ | ======Examples:====== | ||
+ | <file> | ||
+ | $common(one two three / two three four) returns "two three" | ||
+ | $common(one two / three four) returns "" (empty string) | ||
+ | </file> | ||