RAT()
 Retorna a posiçao da última ocorrência de um substring
------------------------------------------------------------------------------

 Sintaxe

     RAT(<cPesquisa>, <cDestino>) --> nPosiçao

 Argumentos

     <cPesquisa> é a cadeia de caracteres a ser localizada.

     <cDestino> é a cadeia de caracteres a ser procurada.

 Retorno

     RAT() retorna a posiçao de <cPesquisa> dentro de <cDestino> na forma de
     um valor numérico inteiro.  Se <cPesquisa> nao for encontrada, RAT()
     retorna zero.

 Descriçao

     RAT() é uma funçao de tratamento de caracteres que retorna a posiçao da
     última ocorrência de um substring em uma cadeia de caracteres.  Isto é
     feito pesquisando-se a cadeia de caracteres destino a partir da
     direita.  RAT() é semelhante à funçao AT(), a qual retorna a posiçao da
     primeira ocorrência de um substring em uma cadeia de caracteres.  RAT()
     também é semelhante ao operador $, que determina se um substring está
     contido em uma cadeia de caracteres.

     As funçoes RAT() e AT() sao usadas juntamente com SUBSTR(), LEFT(), e
     RIGHT() para extrair substrings.

 Exemplos

     Este exemplo utiliza RAT() para criar uma funçao definida pelo usuário,
     FilePath(), que extrai o path de uma especificaçao de arquivo.  Caso
     nao haja especificaçao de path, FilePath() retorna uma cadeia de
     caracteres nula (""):

     ? FilePath("C:\DBF\Sales.dbf")                // Resulta: C:\DBF\

     FUNCTION FilePath( cFile )
        LOCAL nPos, cFilePath
        IF (nPos := RAT("\", cFile)) != 0
           cFilePath = SUBSTR(cFile, 1, nPos)
        ELSE
           cFilePath = ""
        ENDIF
        RETURN cFilePath

 Arquivos:  Biblioteca EXTEND.LIB.
 To download this example - click here.

See Also: AT() LEFT() RIGHT() STRTRAN() SUBSTR()