opensecurity-secureos-buffer.md

buffer

概述

供 OpenOS 与 SecureOS I/O 封装层使用的带缓冲类文件流辅助库。

可用性

• 仓库: opensecurity
• 系统: secureos
• 类型: library

来源

• OpenSecurity/src\main\resources\assets\opensecurity\lua\SecureOS\lib\buffer.lua

用法

local buffer = require("buffer")

接口

buffer.close()

• 说明: 在需要时先刷新待写缓冲，标记包装对象已关闭，然后关闭底层流。

buffer.close()

buffer.flush()

• 说明: 把当前待写输出缓冲立即写入底层流。

buffer.flush()

buffer.getTimeout()

• 说明: 返回缓冲读取辅助方法当前使用的读取超时时间，单位为秒。

buffer.getTimeout()

buffer.lines(...)

• 说明: 返回一个迭代器，用来持续从带缓冲流中读取记录。
• 参数:
  • ...

buffer.lines(nil)

buffer.new(mode, stream)

• 说明: 把原始流句柄包装成带缓冲、带读取超时状态且具备读写模式标记的对象。
• 参数:
  • mode
  • stream

buffer.new(nil, nil)

buffer.read(...)

• 说明: 按 Lua 风格格式参数读取数据；如果没有给格式，就按读一行处理。
• 参数:
  • ...

buffer.read(nil)

buffer.seek(whence, offset)

• 说明: 按需先刷新待写缓冲，然后重定位被包装的流，并丢弃缓存的未读数据。
• 参数:
  • whence
  • offset

buffer.seek(nil, nil)

buffer.setTimeout(value)

• 说明: 修改这条流供高层缓冲读取使用的读取超时时间。
• 参数:
  • value

buffer.setTimeout(nil)

buffer.setvbuf(mode, size)

• 说明: 把缓冲模式设置为 no、full 或 line，并可选地调整缓冲区大小。
• 参数:
  • mode
  • size

buffer.setvbuf(nil, nil)

buffer.write(...)

• 说明: 把字符串或数字写入流，并遵循当前缓冲模式。
• 参数:
  • ...

buffer.write(nil)

备注

• buffer.new 返回的实例会包装底层流，并补上行缓冲、格式化读取、超时控制和类文件辅助方法。