String 字符串操作
String 字符串操作
功能
String 原型函数提供长度读取、查找匹配、截取、替换、填充、大小写转换和类型转换能力。
API 列表
| API | 说明 |
|---|---|
| String.len | 返回字符串长度。ASCII 字符串按字节长度计算;非 ASCII 字符串按 Unicode 字符数量计算。 |
| String.trim | 去除字符串首尾空白字符并返回新字符串。 |
| String.trim_start | 去除字符串开头空白字符并返回新字符串。 |
| String.trim_end | 去除字符串末尾空白字符并返回新字符串。 |
| 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.replace_all | 替换字符串中的全部匹配内容。 |
| 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.pad_start | 按目标长度在开头填充字符串。 |
| String.pad_end | 按目标长度在末尾填充字符串。 |
示例
text = ' BT Lang ' result = text.trim().to_uppercase() // 输出:BT LANG print result
注意事项
- 字符串方法均返回新值,不会修改原字符串。
- HTML 转义、反转义和标签剥离已迁移到 html库。
-
char_at、char_code_at的参数按 Unicode 字符下标读取。 -
index_of、last_index_of、search的返回位置按 UTF-8 字节偏移计算。