# 字节

**原始字节流类型，用于底层内存、文件与网络 I/O。**

```xuantie
设 数据: 字节
```

## 你可以……

- **在声明与外函数签名中作类型注解**：

```xuantie
外 函 读原始(路径: 字): 字节
```

- **配合字符串做字节级访问**——`.字节(i)` 取第 `i` 个字节值（0–255 的 `整`），`.字节数` 取字节长度：

```xuantie
示("Hi".字节(0))   // 72
示("你好".字节数)   // 6
```

- **建 `字节(容量)` 缓冲**（容量不够自动扩容）——`.追加(字节值)` 逐个写入，[`字节到字符串(字节)`](../手册/06_标准库与RuntimeAPI.md) 按 UTF-8 严格校验后转回 字；非法字节或非字节输入**明确报错退出**（不静默产出坏字符串）：

```xuantie
设 缓冲 = 字节(16)
缓冲.追加(231)       // 0xE7
缓冲.追加(142)
缓冲.追加(132)       // 至此为 "玄" 的 UTF-8 三字节
示(字节到字符串(缓冲))   // 玄
```

## 注意

*   本词是**保留字**：不能用作变量名、函数名、参数名等标识符（完整规则与清单见 [词法与基础语法](../手册/01_词法与基础语法.md#保留字不可作标识符)）。
- `字节数` 按字节计，不是字符数——UTF-8 中一个汉字占 3 字节；按字符处理请用 `截取`（字符索引）。
- `.字节(i)` 返回的是 `整` 字节值，不是 `字节` 类型，别混淆。

## 相关

[字](字.md) · [数组](数组.md)