RTRIM()
 Remove espaços em branco à direita de uma cadeia de caracteres
------------------------------------------------------------------------------

 Sintaxe

     [R]TRIM(<cString>) --> cTrimString

 Argumentos

     <cString> é a cadeia de caracteres a ser copiada sem os espaços em
     branco à direita.

 Retorno

     RTRIM() retorna uma cópia de <cString>, sendo que os espaços em branco
     à direita foram removidos.  Caso <cString> seja uma cadeia de
     caracteres nula ("") ou totalmente composta por espaços, RTRIM()
     retorna uma cadeia de caracteres nula ("").

 Descriçao

     RTRIM() é uma funçao de tratamento de caracteres utilizada para
     formatar cadeias de caracteres que contenham espaços em branco à
     direita.  Ela é útil quando você deseja eliminar espaços em branco à
     direita ao se concatenar cadeias de caracteres.  É o caso típico com
     campos de banco de dados que sao armazenados em formato de tamanho
     fixo.  Por exemplo, você pode usar RTRIM() para concatenar o primeiro e
     o último campos de nome para formar uma cadeia de caracteres de nome.

     LTRIM() é relacionada a RTRIM(), que remove espaços em branco à
     direita, e a ALLTRIM(), que remove espaços em branco à direita e à
     esquerda.  O contrário de ALLTRIM(), LTRIM(), e RTRIM() sao as funçoes
     PADC(), PADR(), e PADL(), as quais centralizam, alinham à direita, ou
     alinham à esquerda cadeias de caracteres, inserindo caracteres de
     preenchimento.

 Exemplos

       A seguir está uma funçao definida pelo usuário que utiliza
        RTRIM() para formatar um campo cidade, estado, e CEP para etiquetas
        ou cartas padrao:

        FUNCTION CityState(cCity, cState, cZip)
           RETURN RTRIM(cCity) + ", " + RTRIM(cState) + "  " + cZip

       Este exemplo usa CityState() para exibir um registro de
        Customer.dbf:

        USE Customer INDEX CustName NEW
        SEEK "Kate"
        ? CityState(City, State, ZipCode)      // Resulta: Athens, GA  10066

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

See Also: ALLTRIM() LTRIM() PAD() SUBSTR()