Histórico da Página

Sintaxe

STRTRAN( <expressão caracter 1> , <expressão caracter 2>  [ , <expressão caracter 3> ]  [ , <expressão numérica 1> ]  [ , <expressão numérica 2> ] )

Propósito

Pesquisa e substitui caracteres de uma cadeia de caracteres.

Argumentos

< expressão caracter 1>

Define a cadeia de caracteres que será pesquisada e terá determinados caracteres substituídos.

< expressão caracter 2 >

Define os caracteres que deverão ser encontrados na cadeia de caracteres.

< expressão caracter 3 >

Define os caracteres que substituirão os caracteres encontrados. Se não for especificado, todos os caracteres encontrados serão substituídos pelo caracter nulo (“”). Ou seja, serão eliminados.

< expressão numérica 1 >

Define o número da primeira ocorrência que deverá ser encontrada e substituída. Se não for especificado, assume-se o valor 1 (primeira ocorrência).

< expressão numérica 2 >

Define o número de ocorrências que serão encontradas e substituídas. Se não for especificado, todas as ocorrências serão substituídas.

Utilização

Quando uma ocorrência da expressão caracter 2 é encontrada na expressão caracter 1, ela é substituída pelos caracteres especificados na expressão caracter 3.

Caso as expressões numéricas 1 e 2 não sejam especificadas, todas as ocorrências da expressão caracter 2 encontradas na expressão caracter 1 serão substituídas pela expressão caracter 3. Se ambas forem especificadas, apenas um determinado número de ocorrências será substituído.

Exemplos

cTexto := “Ser ou não Ser, eis a questão!”

cTexto1 := STRTRAN(cTexto, “Ser”, “Programar”)

O conteúdo da variável cTexto1 será “Programar ou não Programar, eis a questão!”.