+---------------------------------+
|               RAT               |
+---------------------------------+
RAT(<expC1>, <expC2> [, <expN>])

-----------------------------------
Searches expression starting from right for occurrence of another
expression, and returns position where expression was found.
Return value - Numeric
-----------------------------------

RAT() searches a character expression, starting with the last character,
for the occurrence of another character expression.  It then returns an
integer corresponding to the position where the character expression is
found.  If the character expression isn't found, 0 is returned.

The search performed by RAT() is case sensitive (upper and lower-case is
respected).

<expC1>, <expC2>
        RAT() looks for <expC1> in <expC2>.  <expC1> and <expC2> may be memo
fields.

<expN>
        Including <expN> lets you search for additional occurrences of <expC1>
in <expC2>.  By default, RAT() searches for the first occurrence of
<expC1> (<expN> = 1).  If <expN> is included, RAT() searches for the
<expN>th occurrence of <expC1> in <expC2>.

+---------------------------------+
|             Examples            |
+---------------------------------+
STORE 'abracadabra' TO string
STORE 'a' TO find_str
? RAT(find_str,string)

? RAT(find_str,string,3)

-----------------------------------

See Also:  AT(), LEFT(), OCCURS(), RATLINE(), RIGHT(), SUBSTR()

-----------------------------------