MEMOTRAN()
 Substitui carriage return/line feeds (retornos manuais) em cadeias de
 caracteres
------------------------------------------------------------------------------

 Sintaxe

     MEMOTRAN(<cString>,
        [<cSubstManualCR>],
        [<cSubstAutomCR>]) --> cNovoString

 Argumentos

     <cString> é a cadeia de caracteres ou campo memo a ser pesquisado.

     <cSubstManualCR> é o caractere que substituirá o hard carriage
     return/line feed.  Se nao for especificado, o valor padrao é um
     ponto-e-vírgula (;).

     <cSubstAutomCR> é o caractere que substituirá o soft carriage
     return/line feed.  Se nao for especificado, o valor padrao é espaço.

 Retorno

     MEMOTRAN() retorna uma cópia de <cString> com o carriage return/line
     feed especificado já substituido.

 Descriçao

     MEMOTRAN() é uma funçao de tratamento de memos que converte um campo
     memo ou uma cadeia de caracteres longa que contém caracteres carriage
     return/line feed soft e hard (manuais e automáticos) para uma forma que
     pode ser exibida.  Estas duas combinaçoes de caracteres sao indicadores
     de formataçao de final de linha colocadas na cadeia de caracteres pela
     funçao MEMOEDIT().  Soft carriage returns (automáticos) (CHR(141)) sao
     inseridos quando uma linha maior do que a largura da janela de
     MEMOEDIT() é transportada.  Hard carriage returns (manuais) (CHR(13))
     sao inseridos quando o usuário pressiona a tecla Return.

     MEMOTRAN() é especialmente útil ao se exibir um campo memo em um REPORT
     FORM que nao seja transportado ao encontrar um soft carriage return
     (automático).  MEMOTRAN() resolve isto convertendo os soft carriage
     returns (automáticos) em  espaços.  Note, porém, que se MEMOTRAN() for
     utilizada em um REPORT FORM e nao for especificada em nenhum outro
     lugar no programa corrente, ela deve ser declarada EXTERNAL.

 Exemplos

     Este exemplo remove todos os caracteres de final de linha de um campo
     memo:

     REPLACE Notes WITH MEMOTRAN(Notes, " ", " ")

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

See Also: HARDCR() STRTRAN() EXTERNAL REPORT FORM