Filter 函数
应用对象
Microsoft 365 专属 Access Access 2024 Access 2021 Access 2019 Access 2016
返回一个从零开始的数组，其中包含基于指定的筛选条件的字符串数组的子集。
语法
筛选 (sourcearray、match [、include ] [， compare ] )
Filter 函数语法具有以下参数：
| 参数 | 说明 |
|---|---|
| sourcearray | 必需。 要搜索的字符串的一维数组。 |
| 匹配 | 必需。 要搜索的字符串。 |
| include | 可选。 指示是否返回包含或排除匹配的子字符串的布尔值。 如果 include 为 True， 则 Filter 返回包含 匹配 的数组的子集作为子字符串。 如果 include 为 False， 则 Filter 返回不包含 匹配 项作为子字符串的数组的子集。 |
| 比较 | 可选。 指示要使用的字符串比较类型的数值。 有关值，请参阅设置部分。 |
“设置”
compare 参数可以具有以下值：
| 不断 | 值 | 说明 |
|---|---|---|
| vbUseCompareOption | –1 | 使用 Option Compare 语句的设置执行比较。 |
| vbBinaryCompare | 0 | 执行二进制比较。 |
| vbTextCompare | 1 | 执行文本比较。 |
备注
如果在 sourcearray 中找不到匹配项，Filter 将返回一个空数组。 如果 sourcearray 为 Null 或不是一维数组，则会发生错误。
Filter 函数返回的数组仅包含足以包含匹配项数的元素。