# $EPIC: tow.txt,v 1.5 2007/03/02 02:32:04 jnelson Exp $
======Synopsis:======
$__tow__(<word> <word list>)

======Technical:======
   * If the <word> argument is omitted this function returns the empty string.
   * If <word> is not found in <pattern list>, this function returns the empty string.
   * Otherwise, the function behaves "as if" the following had been performed: \\ <val> = findw(<word> <word list>) + 1 \\ <function_return> = leftw(<val> <word/pattern list>)
   * Remember that <word list> is a list of [[what is a word|words]].

======Returns:======
Portion of <word list> before and including a literally matching word.

======Examples:======
<file>
$tow(foobar one two foobar my shoe)    returns "one two foobar"
$tow(booya one two foobar my shoe)     returns ""  (empty string)
</file>

======History:======
This function first appeared in "plus 2" (post-ircII, pre-EPIC)