Função Substituir

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:

000238882349940
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 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.