# 文本

Text 使用 UTF-8；位置和长度按 Unicode 码点计算。

## text.trim

移除文本两端的 Unicode 空白。

## text.lower

按 Unicode 规则转换为小写。

## text.upper

按 Unicode 规则转换为大写，转换结果可以包含更多字符。

## text.codepoint

文本恰好包含一个 Unicode 标量时返回其整数值，否则返回 null。

## text.fromCodepoint

把有效 Unicode 标量值转换为文本；负数、代理区和超出范围的值返回 null。

## text.at

按从 0 开始的 Unicode 标量位置取单个字符；越界返回 null。

## text.slice

按 Unicode 标量位置返回半开区间 [start, end)；负数、倒序或越界返回 null。

## text.indexOf

返回首个匹配子串的 Unicode 标量位置；未匹配返回 null，空 pattern 返回 0。

## text.contains

判断文本是否包含给定子串。

## text.startsWith

判断文本是否以给定前缀开头。

## text.endsWith

判断文本是否以给定后缀结尾。

## text.split

按给定分隔文本拆分；空分隔符按 Unicode 标量拆分，不产生首尾空项。

## text.replace

替换所有匹配子串；空 pattern 会在字符边界及首尾插入 replacement。

## text.isEmpty

判断文本是否为空。

## text.join

按列表顺序拼接，在相邻元素之间插入 separator；空列表产生空文本。