# String 字符串操作

## 功能

String 原型函数提供长度读取、查找匹配、截取、替换、大小写转换、HTML 转义和类型转换能力。

## API 列表

| API | 说明 |
| ------ | ------ |
| [String.len](/docs/string/len) | 返回字符串长度。ASCII 字符串按字节长度计算；非 ASCII 字符串按 Unicode 字符数量计算。 |
| [String.trim](/docs/string/trim) | 去除字符串首尾空白字符并返回新字符串。 |
| [String.char_at](/docs/string/char_at) | 读取指定字符位置的字符。 |
| [String.char_code_at](/docs/string/char_code_at) | 读取指定字符位置的 Unicode 码点。 |
| [String.parse_json](/docs/string/parse_json) | 解析 JSON 字符串为 BT 值。 |
| [String.parse_radix_int](/docs/string/parse_radix_int) | 按指定进制解析整数文本。 |
| [String.parse_radix_str](/docs/string/parse_radix_str) | 按指定进制把空白分隔的字节文本解析为 UTF-8 字符串。 |
| [String.concat](/docs/string/concat) | 把当前字符串与所有参数按顺序拼接为新字符串。 |
| [String.ends_with](/docs/string/ends_with) | 判断字符串是否以指定后缀结尾。 |
| [String.contains](/docs/string/contains) | 判断字符串是否包含指定片段。 |
| [String.index_of](/docs/string/index_of) | 返回指定片段第一次出现的位置。 |
| [String.last_index_of](/docs/string/last_index_of) | 返回指定片段最后一次出现的位置。 |
| [String.repeat](/docs/string/repeat) | 按次数重复当前字符串。 |
| [String.replace](/docs/string/replace) | 替换字符串中的匹配内容。字符串模式只替换第一次出现；Regex 参数带 g 标志时替换全部匹配。 |
| [String.search](/docs/string/search) | 查找字符串或正则表达式在当前字符串中的首次匹配位置。 |
| [String.match](/docs/string/match) | 返回字符串或正则表达式匹配结果。 |
| [String.slice](/docs/string/slice) | 按起止位置截取字符串。 |
| [String.split](/docs/string/split) | 按分隔符拆分字符串。 |
| [String.starts_with](/docs/string/starts_with) | 判断字符串是否以指定前缀开头。 |
| [String.substr](/docs/string/substr) | 从指定位置开始按长度截取字符串。 |
| [String.to_lowercase](/docs/string/to_lowercase) | 把字符串转换为小写。 |
| [String.to_uppercase](/docs/string/to_uppercase) | 把字符串转换为大写。 |
| [String.to_number](/docs/string/to_number) | 把字符串按 BT 宽松数字规则转换为数字值。 |
| [String.to_string](/docs/string/to_string) | 返回当前字符串本身。 |
| [String.escape_html](/docs/string/escape_html) | 转义 HTML 特殊字符。 |
| [String.unescape_html](/docs/string/unescape_html) | 还原常见 HTML 实体。 |
| [String.strip_html](/docs/string/strip_html) | 删除字符串中的 HTML 标签，保留标签外文本。 |

## 示例

```bt
text = '  BT Lang  '
result = text.trim().to_uppercase()

// 输出：BT LANG
print result
```

## 注意事项

- 字符串方法均返回新值，不会修改原字符串。
- `char_at`、`char_code_at` 的参数按 Unicode 字符下标读取。
- `index_of`、`last_index_of`、`search` 的返回位置按 UTF-8 字节偏移计算。