Função INCLUDE( )

Retorna uma cadeia que inclui apenas os caracteres especificados.

Sintaxe

INCLUDE(cadeia; caracteres_a_incluir)

Parâmetros

Nome	Tipo	Descrição
cadeia	caractere	O valor de restrição de caracteres inclusos.
caracteres_a_incluir	caractere	A lista de caracteres a serem incluídos. Se você especificar aspas em caracteres_a_incluir, deverá colocar a lista de caracteres entre apóstrofos. Por exemplo: '"-/' Nota Se o caractere especificado para inclusão não aparecer na cadeia, não será incluído no valor de retorno.

Saída

Caractere.

Exemplos

Exemplos básicos

Retorna "123", que é a cadeia de entrada com apenas números incluídos:

INCLUDE("Rua Principal 123"; "0123456789")

Retorna "1231234", que é a cadeia de entrada com apenas números incluídos:

INCLUDE("123-123-4"; "1243")

Retorna "" (nada) porque a cadeia de entrada não contém "D":

INCLUDE("ABC"; "D")

Observações

Como funciona?

A função INCLUDE( ) compara cada caractere na cadeia com os caracteres listados em caracteres_a_incluir. Se ocorrer uma correspondência, o caractere é incluído na cadeia de saída.

Nenhum caractere correspondente

Se não houver correspondências entre cadeia e caracteres_a_incluir, o resultado da função será em branco.

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

A função INCLUDE( ) distingue entre maiúsculas e minúsculas. Se especificar "ID" em caracteres_a_incluir, os caracteres não são incluídos em "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:

INCLUDE(UPPER("id#94022"); "ID0123456789")

Dica de uso

Use INCLUDE( ) se o conjunto de caracteres a incluir for pequeno e o conjunto de caracteres a excluir for grande.

Funções relacionadas

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