A função Substituir substitui caracteres individuais por
outros caracteres individuais.
A substituição é feita no nível de caractere individual
e não no nível de cadeia. Cada ocorrência de um caractere é substituída
pelo caractere de substituição especificado, conforme mostrado no exemplo a seguir:
- a lista de caracteres a serem substituídos é igual a 'abc'
- a lista de caracteres de substituição é igual a 'ABC'
- a cadeia de entrada é igual a 'aWWWbYYYYcPPPPabc'
A
cadeia de resultados é igual a ''AWWWBYYYYCPPPPABC' porque a substituição
é feita no nível do caractere - cada caractere é substituído. (Se a substituição fosse feita no nível de cadeia, a cadeia
resultante seria igual a 'aWWWbYYYYcPPPPABC'.)
Parâmetro: entrada
A cadeia a ser procurada para
os caracteres a serem substituídos. O valor para este parâmetro pode ser fornecido
por um nó de origem, o resultado de uma outra função ou um valor especificado.
Parâmetro: fromChars
Uma lista dos caracteres a
serem substituídos. Se você precisar substituir vários caracteres, eles deverão
ser listados sem qualquer separação. O valor para este parâmetro pode
ser fornecido por um nó de origem, o resultado de uma outra função ou um
valor especificado.
Parâmetro: toChars
Uma lista dos caracteres a
serem usados como substituições. Liste os caracteres de substituição neste
parâmetro na mesma ordem que os caracteres a serem substituídos no
parâmetro
fromChars porque o primeiro caractere do
parâmetro
fromChars é substituído pelo primeiro
caractere no parâmetro
toChars e assim por diante.
Para obter informações adicionais,
consulte o Exemplo 2. O valor para este parâmetro pode ser fornecido por um nó
de origem, o resultado de uma outra função ou um valor especificado.
Nota: Não é possível substituir diretamente um único caractere por uma sequência
vazia porque o parâmetro toChars não pode ser igual a
uma sequência vazia - uma sequência sem caracteres. Para uma solução alternativa, consulte o Exemplo 3.
Retorna: cadeia
O resultado da substituição de
todas as ocorrências de caracteres no segundo parâmetro
(fromChars) que estão localizadas no primeiro
parâmetro (input) pelos caracteres correspondentes no
terceiro parâmetro (toChars).
Exemplo 1
Este exemplo mostra uma substituição de caracteres um-a-um simples, conforme mostrado
na figura a seguir:
O resultado de executar essa função no
tempo de execução é a seguinte cadeia:
Uma lista de chArActers
Todos os caracteres minúsculos
são substituídos por caracteres A maiúsculos.
Nota: Neste exemplo, o parâmetro de entrada é codificado permanentemente para um valor
específico.
Geralmente, esse valor é fornecido por um nó de origem em um mapa.
Exemplo 2
Neste exemplo, o primeiro caractere do
parâmetro
fromChars é substituído pelo primeiro
caractere do parâmetro
toChars, o segundo caractere
do parâmetro
fromChars é substituído pelo segundo
caractere do parâmetro
toChars e assim por diante. A substituição de múltiplos caracteres é mostrada na figura a
seguir:
Neste exemplo, os caracteres não numéricos
(especificados no final do parâmetro fromChars) são
removidos a partir da sequência de números de telefone. Todos os
caracteres numéricos são substituídos pelo mesmo caractere numérico; por
exemplo, o caractere 1 é substituído pelo caractere 1. Os outros
caracteres não numéricos no final de fromChars não
possuem um caractere de substituição especificado no
toChars, portanto, eles são removidos da sequência
retornada.
O resultado de executar essa função no
tempo de execução é a seguinte cadeia:
000238882349940Nota: Neste exemplo, o parâmetro de entrada é codificado permanentemente para
um valor específico.
Geralmente, esse valor é fornecido por um nó de origem
em um mapa.
Exemplo 3
Este exemplo mostra uma solução alternativa
à limitação de que não é possível substituir um caractere único por
uma cadeia vazia. Esta limitação existe porque o parâmetro
toChars não pode ser configurado com uma sequência
vazia - uma sequência sem caracteres. É possível solucionar esta limitação
fornecendo um caractere simulado como um hífen (-) que não está localizado
no parâmetro
input.
Por exemplo, seria possível especificar os valores a seguir para os
parâmetros da função
Substituir, conforme mostrado na figura a
seguir:
Neste exemplo, o parâmetro de entrada é
igual a '1 2 3' (1, espaço, 2, espaço, 3), o parâmetro
fromChars é igual a '- ' (hífen, espaço) e o
parâmetro toChars é igual a '-' (hífen). Durante o
tempo de execução, a função Substituir com estes valores remove os
espaços do parâmetro de entrada e o resultado do tempo de execução é a
sequência a seguir:
123
Atenção: Quando você especificar as sequências no campo
Valor da caixa de diálogo Propriedades da Função,
não insira as aspas. Insira apenas o hífen e o espaço, e não
os caracteres de aspas.
Nota: Neste exemplo, o parâmetro
de entrada é codificado permanentemente para um valor específico.
Geralmente, esse valor é
fornecido por um nó de origem em um mapa.