Zum Inhalt springen
Deutsch

二进制数据

Diese Seite ist in der gewählten Sprache noch nicht verfügbar. Angezeigt wird die englische Dokumentation derselben Version.

Snapshot 0.0.18 Dokumentation

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

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
./binary
import 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)
}
3
0
7
中😀
invalid_utf8

Windows 请使用 .exe 输出名并运行对应文件。ku check binary.ku 可检查源码;ku run binary.ku 尚不支持 bytes。二进制值可直接交给 TCP client 的 write,写入不消费原 bytes。