core/lib/doc/dever-bytes.md

字节

Bytes 保存原始字节，按 UTF-8 与 Text 显式转换。

dever.bytes.DecodeResult

UTF-8 解码结果：Decoded 保存文本，Failed 保存错误原因。

分支：

• Decoded(text: Text)：成功结果
• error Failed(message: Text)：失败原因

dever.bytes.BufferResult

字节构造结果：Ready 保存字节，Failed 保存错误原因。

分支：

• Ready(bytes: Bytes)：成功结果
• error Failed(message: Text)：失败原因

dever.bytes.fromText

按 UTF-8 编码复制文本字节。

dever.bytes.toText

完整校验 UTF-8；无效字节不会替换或忽略。

dever.bytes.decoded

成功时返回文本，失败时保持原错误身份。

dever.bytes.fromInts

按顺序转换 0–255 的 Int；超范围失败。

dever.bytes.length

返回字节数。

dever.bytes.at

使用从零开始的索引，越界返回 null。

dever.bytes.slice

截取左闭右开区间，负数、倒置或越界范围失败。

dever.bytes.ready

成功时返回字节，失败时保持原错误身份。

dever.bytes.concat

顺序连接两段字节，保留两个输入的值。