112 lines
1.9 KiB
Markdown
112 lines
1.9 KiB
Markdown
---
|
|
import:
|
|
utf8: "../text/utf8.mq.md"
|
|
---
|
|
|
|
## 读文本
|
|
|
|
`(路径)`
|
|
|
|
以 UTF-8 读取一个有界的项目文件。文件在打开时整文件载入,上限 8 MiB;
|
|
结果使用可恢复 `Result` 形状。
|
|
|
|
**流 = resource.open("file", 路径, ["read"])**
|
|
|
|
**内存 = memory.new(128, 128)**
|
|
|
|
**读取 = resource.read(流, 内存, 0, 8388608)**
|
|
|
|
**关闭 = resource.close(流)**
|
|
|
|
1. `not 读取.ok`
|
|
|
|
*读取*
|
|
|
|
2. `not 关闭.ok`
|
|
|
|
*关闭*
|
|
|
|
3. `true`
|
|
|
|
**文本 = utf8.解码(内存, 0, 读取.value.count)**
|
|
|
|
1. `not 文本.ok`
|
|
|
|
*文本*
|
|
|
|
2. `true`
|
|
|
|
*{ok: true, value: 文本.value}*
|
|
|
|
## 写文本
|
|
|
|
`(路径, 文本)`
|
|
|
|
把文本按 UTF-8 写入项目文件。路径必须已经通过 `fs_write` 授权;
|
|
文件只在 `resource.close` 成功时创建或覆盖,写入缓冲上限 8 MiB。
|
|
|
|
**内存 = memory.new(128, 128)**
|
|
|
|
**长度 = utf8.编码(文本, 内存, 0)**
|
|
|
|
**流 = resource.open("file", 路径, ["write"])**
|
|
|
|
**写入 = resource.write(流, 内存, 0, 长度)**
|
|
|
|
**关闭 = resource.close(流)**
|
|
|
|
1. `not 写入.ok`
|
|
|
|
*写入*
|
|
|
|
2. `not 关闭.ok`
|
|
|
|
*关闭*
|
|
|
|
3. `true`
|
|
|
|
*{ok: true, value: {count: 写入.value.count}}*
|
|
|
|
## 复制文件
|
|
|
|
`(源, 目标)`
|
|
|
|
按字节复制一个有界的项目文件。源读取和目标写入分别需要
|
|
`fs_read`/`fs_write` 授权,结果值与 [`写文本`](#写文本) 相同。
|
|
|
|
**输入 = resource.open("file", 源, ["read"])**
|
|
|
|
**内存 = memory.new(128, 128)**
|
|
|
|
**读取 = resource.read(输入, 内存, 0, 8388608)**
|
|
|
|
**关闭输入 = resource.close(输入)**
|
|
|
|
1. `not 读取.ok`
|
|
|
|
*读取*
|
|
|
|
2. `not 关闭输入.ok`
|
|
|
|
*关闭输入*
|
|
|
|
3. `true`
|
|
|
|
**输出 = resource.open("file", 目标, ["write"])**
|
|
|
|
**写入 = resource.write(输出, 内存, 0, 读取.value.count)**
|
|
|
|
**关闭输出 = resource.close(输出)**
|
|
|
|
1. `not 写入.ok`
|
|
|
|
*写入*
|
|
|
|
2. `not 关闭输出.ok`
|
|
|
|
*关闭输出*
|
|
|
|
3. `true`
|
|
|
|
*{ok: true, value: {count: 写入.value.count}}*
|