User Tools

Site Tools


beforew

Differences

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

Link to this comparison view

beforew [2007/03/02 02:32] (current)
Line 1: Line 1:
 +# $EPIC: beforew.txt,​v 1.4 2007/03/02 02:32:04 jnelson Exp $
 +======Synopsis:​======
 +$__beforew__(<​word>​ <pattern list>)
 +
 +======Technical:​======
 +   * If the <​word>​ argument is omitted this function returns the empty string.
 +   * The <pattern list> does not actually need to be a list of wildcard patterns. ​ A list of literal words will work just fine.
 +   * If <​word>​ is not matched by any of the words in <pattern list>, this function returns the empty string.
 +   * Otherwise, the function behaves "as if" the following had been performed: <val> = rmatch(<​word>​ <​word/​pattern list>) <​function_return>​ = leftw(<​val>​ <​word/​pattern list>)
 +   * Remember that <pattern list> is a list of [[what is a word|words]].
 +
 +======Practical:​======
 +This function lets you get the part of <pattern list> that occurs BEFORE
 +the pattern that is the "best match" for <​word>​. ​ You can of course use
 +this function with a list of literal words.
 +
 +======Returns:​======
 +The portion of <pattern list> before the pattern that is the "best match"
 +of <​word>​. ​ A word is always "best matched"​ by itself; see the help file
 +on pattern matching for more detail.
 +
 +======Examples:​======
 +<​file>​
 +$beforew(foobar one two foobar my shoe)    returns "one two"
 +$beforew(booya one two foobar my shoe)     ​returns "" ​ (empty string)
 +$beforew(foobar o* t* f* m* s*)            returns "o* t*"
 +$beforew(booya o* t* f* m* s*)             ​returns "" ​ (empty string)
 +$beforew(foobar f* fo* foobar foo* foob*) ​ returns "f* fo*"
 +</​file>​
 +
 +======History:​======
 +This function first appeared in "plus 2" (post-ircII,​ pre-EPIC)
  
beforew.txt ยท Last modified: 2007/03/02 02:32 (external edit)