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