STRTRAN()
 Pesquisa e substitui caracteres de uma cadeia de caracteres ou campo memo
------------------------------------------------------------------------------

 Sintaxe

     STRTRAN(<cString>, <cProcura>,
        [<cSubstitui>], [<nInício>], [<nCont>]) --> cNovoString

 Argumentos

     <cString> é a cadeia de caracteres ou campo memo onde será efetuada
     a busca.

     <cProcura> é a sequência de caracteres a ser pesquisada.

     <cSubstitui> é a sequência de caracteres que substituirá
     <cProcura>.  Se este argumento nao for especificado, as ocorrências
     especificadas do argumento de pesquisa sao substituidas por uma cadeia
     de caracteres nula ("").

     <nInício> é a primeira ocorrência a ser substituida.  Caso este
     argumento seja omitido, o padrao é um.

     <nCont> é a quantidade de ocorrências a serem substituidas.  Se
     este argumento nao for especificado, o padrao é todos.

 Retorno

     STRTRAN() retorna uma nova cadeia de caracteres, sendo que as
     ocorrências especificadas de <cProcura> foram substituidas por
     <cSubstitui>.

 Descriçao

     STRTRAN() é uma funçao de tratamento de caracteres que faz a pesquisa
     de um substring padrao em uma cadeia de caracteres.  Ao ser encontrada
     uma correspondência, ela substitui a cadeia de caracteres encontrada
     pela cadeia de caracteres de substituiçao.  Todas as ocorrências de
     <cProcura> sao substituidas, a nao ser que seja especificado <nInício>
     ou <nCont>.  Note que STRTRAN() substitui substrings e, portanto, nao
     considera palavras inteiras.

 Exemplos

     O exemplo a seguir utiliza STRTRAN() para estabelecer uma analogia
     pós-moderna com uma frase famosa do período pré-Iluminismo:

     cString = "programar ou nao programar?"
     ? STRTRAN(cString, "programar", "ser")      // Resulta: ser ou nao ser?

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

See Also: AT() HARDCR() MEMOTRAN() RAT() STUFF() SUBSTR()