Función INCLUDE( )

Devuelve una cadena que incluye solo los caracteres especificados.

Sintaxis

INCLUDE(cadena; caracteres_a_incluir)

Parámetros

Nombre Tipo Descripción
cadena carácter El valor para restringir a los caracteres incluidos.
caracteres_para_incluir carácter

La lista de caracteres que se deben incluir.

Si especifica comillas dobles en caracteres_a_incluir, debe encerrar la lista de caracteres entre comillas simples.

Por ejemplo: '"-/'

Nota

Si un carácter que especifica para incluir no aparece en cadena, no se lo incluye en el valor que se devuelve.

Salida

Carácter.

Ejemplos

Ejemplos básicos

Devuelve "123", que es la cadena de entrada solo con los números incluidos:

INCLUDE("123 Main St."; "0123456789")

Devuelve "1231234", que es la cadena de entrada solo con los números incluidos:

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

Devuelve "" (nada), porque la cadena de entrada no contiene "D":

INCLUDE("ABC"; "D")

Observaciones

Cómo funciona

La función INCLUDE( ) compara cada carácter de la cadena con los caracteres que se incluyen en la lista caracteres_a_incluir. Si hay una coincidencia, el carácter se incluye en la cadena de salida.

Sin coincidencia de caracteres

Si no hay ninguna coincidencia entre cadena y caracteres_a_incluir la salida de la función aparece en blanco.

Coincidir mayúsc.-minúsc.

La función INCLUDE( ) distingue mayúsculas y minúsculas. Si especifica "ID" en caracteres_a_incluir, estos caracteres no es incluyen en "id#94022". Si existe la posibilidad de que las mayúsculas y minúsculas estén mezcladas, primero use la función UPPER( ) para pasar todos los caracteres de la cadena a mayúsculas.

Por ejemplo:

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

Consejos de uso

Utilice INCLUDE( ) si el conjunto de caracteres que desea incluir es pequeño y el conjunto que desea excluir es grande.

Funciones relacionadas

La función INCLUDE( ) es lo opuesto de la función EXCLUDE( ).

Guía de creación de scripts de ACL 14.1