AT()
 Retorna a posiçao de um substring dentro de uma cadeia de caracteres
------------------------------------------------------------------------------

 Sintaxe

     AT(<cPesquisa>, <cDestino>) --> nPosicao

 Argumentos

     <cPesquisa> é o substring a ser procurado.

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

 Retorno

     AT() retorna a posiçao da primeira ocorrência de <cPesquisa> dentro de
     <cDestino> como um valor numérico inteiro.  Se <cPesquisa> nao for
     encontrada, AT() retorna zero.

 Descriçao

     AT() é uma funçao de tratamento de dados tipo caractere utilizada para
     determinar a posiçao da primeira ocorrência de um substring dentro de
     outra cadeia de caracteres.  Caso você precise apenas saber se existe
     um substring dentro de outra cadeia de caracteres, utilize o operador
     $.  Para encontrar a última ocorrência de um substring dentro de uma
     cadeia de caracteres, use RAT().

 Exemplos

       Os exemplos a seguir dao uma idéia geral de como AT()
        funciona:

        ? AT("a", "abcde")               // Resulta: 1
        ? AT("bcd", "abcde")             // Resulta: 2
        ? AT("a", "bcde")                // Resulta: 0

       Este exemplo divide uma cadeia de caracteres com base na
        posiçao de uma vírgula dentro da cadeia de caracteres destino:

        cTarget = "Langtree, Lilly"
        ? SUBSTR(cTarget, 1, AT(",", cTarget) - 1)   // Resulta: Langtree
        ? SUBSTR(cTarget, AT(",", cTarget) + 2)      // Resulta: Lilly

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

See Also: RAT() STRTRAN() SUBSTR()