Filter 函数

应用对象
Microsoft 365 专属 Access Access 2024 Access 2021 Access 2019 Access 2016

返回一个从零开始的数组,其中包含基于指定的筛选条件的字符串数组的子集。

语法

Filter (sourcearray, match [, include ] [, compare ] )

Filter 函数语法具有以下参数:

参数 说明
SourceArray 必需。 要搜索的一维字符串数组。
匹配 必需。 要搜索的字符串。
include 可选。 布值,指示是返回包含还是排除匹配的子字符串。 如果 includeTrue,则 Filter 返回包含 match 作为子字符串的数组的子集。 如果 includeFalse,则 Filter 返回不包含 match 作为子字符串的数组子集。
比较 可选。 指示要使用的字符串比较类型的数值。 有关值,请参阅“设置”部分。

“设置”

比较参数可以具有以下值:

常量 说明
vbUseCompareOption –1 使用 Option Compare 语句的设置执行比较。
vbBinaryCompare 0 执行二进制比较。
vbTextCompare 1 执行文本比较。

备注

如果在 sourcearray 中未找到匹配项,则 Filter 返回空数组。 如果 sourcearrayNull 或不是一维数组,则会发生错误。

Filter 函数返回的数组只包含足够的元素来包含匹配项目的数量。