This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
api:buffer:zh [2023/10/16 11:18] hfsr [实例方法] |
api:buffer:zh [2023/11/29 02:59] hfsr [静态方法] |
||
---|---|---|---|
Line 1: | Line 1: | ||
Buffer(缓冲) API | Buffer(缓冲) API | ||
=========== | =========== | ||
- | `buffer`库提供了便于使用的IO流。本库提供的流更像是`io`库提供的,由`io.open`返回的流,**不像**`filesystem.open`返回的原始流,后者支持的方法没有前者那么多。下文的[[api:buffer:zh#实例方法|实例方法]]板块列出的方法可被用于从`io.open`函数获取的文件句柄。因此就算你没打算构建自定义带缓冲IO流,此API文档也会大有裨益。 | + | `buffer`库提供了便于使用的IO流。本库提供的流更像是`io`库提供的,由`io.open`返回的流,**不像**`filesystem.open`返回的原始流,后者支持的方法没有前者那么多。下文[[api:buffer:zh#实例方法|实例方法]]板块列出的方法也可用于从`io.open`函数获取的文件句柄,因此就算你没打算构建自定义带缓冲流,此API文档也会大有裨益。 |
- | 此外,该API还允许你创建带缓冲IO流。你需要提供后端的流式读取和流式写入,buffer库提供数据缓冲与格式化。一般而言,用户无需构建自己的带缓冲输入输出流。以备参考,io库就使用了带缓冲IO流(包含文件io和控制台io)。 | + | 此外,该API还能让你创建带缓冲流。你需要提供后端的流式读取和流式写入,buffer库提供数据缓冲与格式化。一般而言,用户无需构建自己的带缓冲流。以备参考,io库就使用了带缓冲流(包含文件io和控制台io)。 |
静态方法 | 静态方法 | ||
Line 11: | Line 11: | ||
- `buffer.new([mode: string], stream: table)` | - `buffer.new([mode: string], stream: table)` | ||
- | 将传入的流(`stream`)封装上读写模式(`mode`),以创建一个带缓冲IO流。模式(`mode`)可以为只读(r或`nil`)、读写(rw)或仅写入(w)。请查看`stream`对象所需的流[[api:buffer:zh#实例方法|实例方法]]有关内容。 | + | 将传入的流(`stream`)封装上读写模式(`mode`),以创建一个带缓冲IO流。模式(`mode`)可以为只读(r或`nil`)、读写(rw)或仅写入(w)。请查看`stream`对象所需流的[[api:buffer:zh#实例方法|实例方法]]有关内容。 |
实例方法 | 实例方法 |