RIGHT()
 Retorna um substring que começa com o caractere mais à direita
------------------------------------------------------------------------------

 Sintaxe

     RIGHT(<cString>, <nCont>) --> cSubString

 Argumentos

     <cString> é a cadeia de caracteres da qual serao extraidos
     caracteres.

     <nCont> é a quantidade de caracteres a serem extraidos.

 Retorno

     RIGHT() retorna os caracteres <nCont> mais à direita de <cString>.
     Caso <nCont> seja negativo ou zero, RIGHT() retorna uma cadeia de
     caracteres nula ("").  Se <nCont> for maior que o tamanho da cadeia de
     caracteres, RIGHT() retorna <cString>.  O tamanho máximo é de 65.535
     (64K) bytes.

 Descriçao

     RIGHT() é uma funçao de tratamento de caracteres a qual extrai um
     substring que começa com o caractere mais à direita em <cString>.  É o
     mesmo que a expressao caractere, SUBSTR(<cString>, -<nCont>).  Por
     exemplo, RIGHT("ABC", 1) é o mesmo que SUBSTR("ABC", -1).  RIGHT() é
     relacionado a LEFT(), a qual extrai um substring que começa com o
     caractere mais à esquerda em <cString>.

     As funçoes RIGHT(), LEFT(), e SUBSTR() geralmente sao utilizadas
     juntamente com as funçoes AT() e RAT() para localizar a primeira e/ou a
     última posiçao de um substring antes de extrai-lo.

 Exemplos

       Este exemplo ilustra a relaçao entre RIGHT() e SUBSTR():

        ? RIGHT("ABCDEF", 3)             // Resulta: DEF
        ? SUBSTR("ABCDEF", -3)           // Resulta: DEF

       Este exemplo extrai um substring a partir do final de uma
        cadeia de caracteres até a última ocorrência de uma vírgula:

        LOCAL cName := "James,William"
        ? RIGHT(cName,;
           LEN(cName) - RAT(",", cName) - 1)       // Resulta: William

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

See Also: LEFT() LTRIM() RTRIM() STUFF() SUBSTR()