# String 字符串操作

## 功能

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

## API 列表

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

## 示例

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

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

## 注意事项

- 字符串方法均返回新值，不会修改原字符串。
- HTML 转义、反转义和标签剥离已迁移到 [html库](/zh-hans/docs/html)。
- `char_at`、`char_code_at` 的参数按 Unicode 字符下标读取。
- `index_of`、`last_index_of`、`search` 的返回位置按 UTF-8 字节偏移计算。