字符串
Diese Seite ist in der gewählten Sprache noch nicht verfügbar. Angezeigt wird die englische Dokumentation derselben Version.
Snapshot 0.0.19 Dokumentation
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
字符串函数用于检查 UTF-8 文本或生成新字符串。只读检查后原值仍可使用。模块形式 string.len(text) 与方法形式 text.len() 调用同一操作。
导入
“导入”章节import string from "std.string"只有使用 string 模块名时才需要这一具名导入;仅使用实例方法不需要导入。Ku 会报告未使用的具名导入。
接口参考
“接口参考”章节以下是文档签名;返回类型中的 ! 表示 Result,可用 ? 传播错误。
| 函数 | 返回 | 含义 |
|---|---|---|
string.len(text:str) |
int |
Unicode 标量数量。 |
string.byte_len(text:str) |
int |
UTF-8 字节数。 |
string.chars(text:str) |
[str] |
按 Unicode 标量拆成可独立使用的字符串。 |
string.contains(text:str, needle:str) |
bool |
精确子串查找。 |
string.starts_with(text:str, prefix:str) |
bool |
精确前缀判断。 |
string.ends_with(text:str, suffix:str) |
bool |
精确后缀判断。 |
string.slice(text:str, start:int, end:int) |
str! |
按标量下标取半开区间 [start, end)。 |
string.replace(text:str, from:str, to:str) |
str |
替换所有匹配项。 |
string.trim(text:str) |
str |
删除两端空白。 |
string.lower(text:str) |
str |
返回小写文本。 |
string.upper(text:str) |
str |
返回大写文本。 |
长度统计 Unicode 标量,不是视觉字素;组合 emoji 或带组合附加符的字符可能计为多个。切片下标不是字节偏移。负下标、start > end 或结束位置越界,返回 string/slice_error。
完整示例
“完整示例”章节保存为 strings.ku,使用 ku run strings.ku;或使用 ku build --backend c -o strings strings.ku 编译后运行。
import string from "std.string"
fn main(): null! { text = "中😀 Ku" println(string.len(text)) println(text.byte_len()) println(text.contains("Ku")) println(text.slice(0, 2)?) letters = text.chars() println(letters[1]) println(text) try { text.slice(9, 10)? } catch (error) { println(error.code) } return ok(null)}510true中😀😀中😀 Kuslice_error后端支持
“后端支持”章节此示例适用于解释器和同步 native C。v0.0.19 的 Unicode trim、lower、upper 仅由解释器实现,native C 会拒绝编译;表中其他接口已有 native C 实现。同步示例不表示通用 native Task 或 LLVM 支持。