Função EXCLUDE( )

Retorna uma cadeia que exclui os caracteres especificados.

Sintaxe

EXCLUDE(cadeia; caracteres_a_excluir)

Parâmetros

Nome Tipo Descrição
cadeia caractere O valor de onde os caracteres serão excluídos.
caracteres_a_excluir caractere

A lista de caracteres a serem excluídos.

Se você especificar aspas em caracteres_a_excluir, deverá colocar a lista de caracteres entre apóstrofos.

Por exemplo: '"-/'

Saída

Caractere.

Exemplos

Exemplos básicos

Retorna " Alberni Street", que é a cadeia de entrada com todos os números excluídos:

EXCLUDE("1550 Alberni Street"; "0123456789")

Retorna todos os valores do campo Número_Produto, com a barra e a cerquilha excluídos:

EXCLUDE(Número_Produto; "/#")

Observações

Como funciona?

A função EXCLUDE( ) compara cada caractere na cadeia com os caracteres listados em caracteres_a_excluir. Se ocorrer uma correspondência, o caractere é excluído da cadeia resultante.

Por exemplo, a saída para EXCLUDE("123-45-4536"; "-") é "123454536".

Nenhum caractere correspondente

Se não houver correspondências entre cadeia e caracteres_a_excluir, a cadeia e a saída da função serão iguais.

Por exemplo, a saída de EXCLUDE("ABC"; "D") é "ABC".

Diferenciação de maiúsculas e minúsculas

A função EXCLUDE( ) distingue entre maiúsculas e minúsculas. Se você especificar "ID" em caracteres_a_excluir, esses caracteres não são excluídos de "id#94022". Se houver a possibilidade de combinação de minúsculas e maiúsculas, use a função UPPER( ) para converter a cadeia em letras maiúsculas.

Por exemplo:

EXCLUDE(UPPER("id#94022"); "ID#")

Dica de uso

Use EXCLUDE( ) se o conjunto de caracteres a excluir é pequeno e o conjunto de caracteres a incluir é grande.

Exclusão de apóstrofos e aspas

As aspas são usadas como delimitadores de cadeias. Portanto, para excluir apóstrofos e aspas, é necessário aninhar o EXCLUDE( ) para que haja uma única função para apóstrofos e uma única função para aspas:

EXCLUDE(EXCLUDE(campo_a_processar; "'"); '"')

Funções relacionadas

A função EXCLUDE( ) é oposta à função INCLUDE( ).

Guia de scripting do ACL 14.1