Files
marqdo-cli/stdlib/io/console.mq.md
T

120 lines
1.8 KiB
Markdown

---
import:
format: "../format.mq.md"
stream: "./stream.mq.md"
utf8: "../text/utf8.mq.md"
---
## 读取行
`()`
从已授权的 `stdio/stdin` 资源读取一行。按有界块读取并增量解码 UTF-8;
EOF 返回 `{ok:false, code:"io.eof"}`,无效 UTF-8 返回可恢复错误。
**流 = resource.open("stdio", "stdin", ["read"])**
**内存 = memory.new(1, 1)**
**字节 = []**
**结束 = false**
**错误 = ""**
- `not 结束`
**读取 = resource.read(流, 内存, 0, 1)**
1. `not 读取.ok`
**结束 = true**
**错误 = 读取.code**
2. `读取.value.eof and 读取.value.count == 0`
**结束 = true**
3. `内存[0] == 10`
**结束 = true**
4. `true`
**字节 = list.append(字节, 内存[0])**
**关闭 = resource.close(流)**
1. `错误 != ""`
*{ok: false, code: 错误, message: "stdin read failed"}*
2. `not 关闭.ok`
*关闭*
3. `长度(字节) == 0`
*{ok: false, code: "io.eof", message: "end of input"}*
4. `true`
**数据长度 = 长度(字节)**
1. `数据长度 > 0 and 字节[数据长度 - 1] == 13`
**数据长度 = 数据长度 - 1**
2. `true`
**忽略 = 0**
**页 = (数据长度 + 65535) // 65536**
**数据 = memory.new(页, 页)**
**下标 = 0**
- `下标 < 数据长度`
**`数据[下标] = 字节[下标]`**
**下标 = 下标 + 1**
**解码 = utf8.解码(数据, 0, 数据长度)**
1. `not 解码.ok`
*解码*
2. `true`
*{ok: true, value: 解码.value}*
## 打印
`(值)`
**结果 = stream.写文本(format.显示(值) + "\n")**
1. `not 结果.ok`
*结果*
2. `true`
*{ok: true, value: None}*
## 写文本
`(文本)`
*stream.写文本(文本)*
## 写全部
`(流, 内存, 起点, 长度)`
*stream.写全部(流, 内存, 起点, 长度)*