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