二进制数据
Această pagină nu este disponibilă în limba selectată. Este afișată documentația în engleză pentru aceeași versiune.
Acest conținut nu este încă disponibil în limba selectată.
std.bytes 保存拥有内容的二进制数据,可包含 NUL 和非 UTF-8 字节。此模块仅用于生成的 native C 程序,解释器尚未实现。
导入与接口
“导入与接口”章节import bytes from "std.bytes"| 函数或方法 | 返回 | 含义 |
|---|---|---|
bytes.from_str(text:str) |
bytes 的 Result | 复制 UTF-8 字节,生成独立二进制值。 |
bytes.from_array(values:[int]) |
bytes 的 Result | 复制整数数组,各项必须在 0..255。 |
data.len() |
int |
字节长度。 |
data.get(index:int) |
int! |
读取一个字节,返回 0..255。 |
data.to_str() |
str! |
严格校验 UTF-8,返回独立字符串。 |
data.clone() |
bytes | 生成独立二进制副本。 |
bytes 类型由构造函数推断,不需要另写公开类型名。构造长度上限 64 MiB。非法整数返回 bytes/invalid_byte;负下标或越界返回 bytes/index_out_of_bounds;非法文本返回 bytes/invalid_utf8;可恢复分配失败返回 bytes/out_of_memory。不会把非法文本静默替换后当作成功。
完整示例
“完整示例”章节保存为 binary.ku,构建并运行 native 产物:
ku build --backend c -o binary binary.ku./binaryimport bytes from "std.bytes"
fn main(): null! { data = bytes.from_array([65, 0, 255])? copy = data.clone() println(data.len()) println(copy.get(1)?) text = bytes.from_str("中😀")? println(text.len()) println(text.to_str()?) try { data.to_str()? } catch (error) { println(error.code) } return ok(null)}307中😀invalid_utf8Windows 请使用 .exe 输出名并运行对应文件。ku check binary.ku 可检查源码;ku run binary.ku 尚不支持 bytes。二进制值可直接交给 TCP client 的 write,写入不消费原 bytes。