INCLUDE( ) 函数

返回一个仅包括指定字符的字符串。

语法

INCLUDE(字符串要包括的字符

参数

名称 类型 描述
字符串 字符 限制在所包括字符内的值。
要包括的字符 字符

要包括的字符列表。

如果您在要包括的字符中指定双引号,则必须将字符列表放在单引号中。

例如:'"-/'

说明

如果您指定包括的字符未出现在字符串中,则它不会被包括在返回值中。

输出

字符。

示例

基本示例

返回 "123",这是只包括数字的输入字符串:

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

返回 "1231234",这是只包括数字的输入字符串:

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

返回 ""(无),因为输入字符串不包含 "D":

INCLUDE("ABC", "D")

备注

工作原理

INCLUDE( ) 函数将字符串中的每个字符与要包括的字符中列出的字符进行比较。如果发生匹配,则该字符被包括在输出字符串中。

没有匹配的字符

如果字符串要包括的字符之间不存在匹配,则该函数的输出为空。

区分大小写

INCLUDE( ) 函数区分大小写。如果您在要包括的字符中指定 "ID",则 "id#94022" 中将不包括这些字符。如果有可能混用大小写,请使用 UPPER( ) 函数将字符串转换为大写形式。

例如:

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

用法提示

如果您想要包括的字符集很小,并且您想要排除的字符集很大,请使用 INCLUDE( )。

相关函数

INCLUDE( ) 函数是 EXCLUDE( ) 函数的逆函数。

ACL 脚本指南 14.1