Histórico da Página
Realizar Função ADVPL utilizada para realizar a substituição de um conteúso conteúdo em um texto por outro, podendo indicar posição inicial e final e também ignorar ou não textos em CAIXA ALTA ou caixa baixa (CASE SENSITIVE).
Sintaxe
Bloco de código |
---|
_ADVPL_STRING_replace( < cText >, < cFrom >, < cTo >, [ <nInitialPosition> ], [ <nFinalPosition> ], [ <lCaseSensitive> ] ) => CHAR |
Parâmetros
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
cText |
| Sim | Texto de origem para ter contéudos substituídos. |
cFrom |
| Sim | Texto de origem para ter contéudos substituídos. |
cTo |
| Sim | Texto de origem para ter contéudos substituídos.
|
nInitialPosition |
| Não | Posição inicial do conteúdo de <cText> a partir da qual deverá considerar as substituições de valores.
|
nFinalPosition |
| Não | Posição final do conteúdo de <cText> até onde deverá considerar as substituições de valores.
|
lCaseSensitive |
| Não | Indica se deverá considerar na pesquisa de <cFrom> em <cText> quando houver diferença de conteúdo apenas devido a letras maiúsculas (CAIXA ALTA) ou minúsculas (caixa baixa). TRUE(PADRÃO) - Somente fará substituição quando identificar um conteúdo exatamente igual de <cFrom> em <cText>. FALSE - Fará substituição de todo conteúdo <cFrom> que encontrar em <cText>, mesmo quando a diferença for apenas devido a letras maiúsculas (CAIXA ALTA) ou minúsculas (caixa baixa).
|
Retorno
Tipo | Descrição |
---|---|
| Conteúdo <cText> com os valores <cFrom> substituídos por <cTo>, considerando os demais parâmetros da função. |
Exemplo
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
#---------------------------------------# FUNCTION STRING_replace_test() #---------------------------------------# DEFINE l_conteudo VARCHAR(1000) LET l_conteudo = "Teste de troca de conteúdo de um texto qualquer por outro texto novo." #Nao irá substituir valor pois não encontra o texto QUALQUER (em caixa alta) LET l_conteudo = _ADVPL_STRING_replace(l_conteudo,'QUALQUER',"original') CALL conout("SUBSTITUIÇÃO 1 = "||l_conteudo) #Irá substituir valor pois encontra o texto QUALQUER indiferentemente de estar escrito em CAIXA ALTA ou baixa. LET l_conteudo = _ADVPL_STRING_replace(l_conteudo,'QUAlquer',"original',0,0,FALSE) CALL conout("SUBSTITUIÇÃO 2 = "||l_conteudo) END FUNCTION |
Informações
Fontes: string.prw
Disponível a partir do pacote Logix 12.1.2209.
Veja também
...