# String.match

## 功能

返回字符串或正则表达式匹配结果。

## 语法

```bt
string.match(pattern)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| pattern | String/Regex | 否 | '' | 要匹配的字符串或正则表达式。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Array/Empty | 字符串模式匹配成功返回包含 needle 的数组；正则无 g 标志时返回捕获组数组；正则带 g 标志时返回所有匹配文本；未匹配返回 Empty。 |

## 示例

```bt
text = 'hello BT'
result = text.match('BT')

// 输出：["BT"]
print result
```

## 注意事项

- 正则无 g 标志时，第 0 项是完整匹配，后续项是捕获组；未命中的捕获组为 Null。