YStudio Y++

字节流支持库

Y++ / YStudio 开发文档 · 一点滴

路径:支持库 → 字节流支持库 → 二进制。

硬约束

  1. 扁平命令;二进制缓冲:读写文件、十六进制、按代码页编解码文本。
  2. 默认代码页 UTF-8=65001,GBK=936。
  3. 创建/读文件失败返回句柄 0;查 字节流_取错误()。
  4. 用完必须 字节流_释放。
  5. 单字节值 0~255;索引从 0;越界 取字节 返回 -1。
  6. 到十六进制 为大写、无空格。

快速开始

整数 b = 字节流_创建()
字节流_从文本(b, "你好", 65001)
字节流_写文件(b, "a.bin")
输出(字节流_到十六进制(b))
字节流_释放(b)

b = 字节流_读文件("a.bin")
输出(字节流_到文本(b, 65001))
字节流_释放(b)

二进制

本分类共 15 条。

字节流_创建

  • 签名:整数 字节流_创建()
  • 说明:创建空字节流,成功返回句柄。

字节流_读文件

  • 签名:整数 字节流_读文件(文本 文件路径)
  • 说明:极速读取整个文件为字节流。
  • 参数一│文件路径

字节流_写文件

  • 签名:逻辑 字节流_写文件(整数 句柄, 文本 文件路径)
  • 说明:极速写入二进制文件。
  • 参数一│句柄
  • 参数二│文件路径

字节流_取长度

  • 签名:整数 字节流_取长度(整数 句柄)
  • 说明:返回字节数。
  • 参数一│句柄

字节流_清空

  • 签名:逻辑 字节流_清空(整数 句柄)
  • 说明:清空内容。
  • 参数一│句柄

字节流_追加字节

  • 签名:逻辑 字节流_追加字节(整数 句柄, 整数 字节)
  • 说明:追加一个字节(0~255)。
  • 参数一│句柄
  • 参数二│字节

字节流_置字节

  • 签名:逻辑 字节流_置字节(整数 句柄, 整数 索引, 整数 字节)
  • 说明:按索引设置字节;索引从 0 起。
  • 参数一│句柄
  • 参数二│索引
  • 参数三│字节

字节流_取字节

  • 签名:整数 字节流_取字节(整数 句柄, 整数 索引)
  • 说明:取字节;越界返回 -1。
  • 参数一│句柄
  • 参数二│索引

字节流_到十六进制

  • 签名:文本 字节流_到十六进制(整数 句柄)
  • 说明:转为大写十六进制文本(无空格)。
  • 参数一│句柄

字节流_从十六进制

  • 签名:逻辑 字节流_从十六进制(整数 句柄, 文本 十六进制)
  • 说明:用十六进制文本覆盖内容。
  • 参数一│句柄
  • 参数二│十六进制

字节流_到文本

  • 签名:文本 字节流_到文本(整数 句柄, [整数 代码页=65001])
  • 说明:按代码页解码为文本。65001=UTF-8,936=GBK。
  • 参数一│句柄
  • 参数二│[代码页=65001]

字节流_从文本

  • 签名:逻辑 字节流_从文本(整数 句柄, 文本 内容, [整数 代码页=65001])
  • 说明:用文本按代码页编码后覆盖内容。
  • 参数一│句柄
  • 参数二│内容
  • 参数三│[代码页=65001]

字节流_追加文本

  • 签名:逻辑 字节流_追加文本(整数 句柄, 文本 内容, [整数 代码页=65001])
  • 说明:追加文本编码后的字节。
  • 参数一│句柄
  • 参数二│内容
  • 参数三│[代码页=65001]

字节流_释放

  • 签名:逻辑 字节流_释放(整数 句柄)
  • 说明:释放句柄。
  • 参数一│句柄

字节流_取错误

  • 签名:文本 字节流_取错误()
  • 说明:取最近失败原因。

易错对照

错误 正确
忘记释放 字节流_释放
编码与编码支持库混淆 本库按代码页整数;字符集名见编码支持库

相关

字节集(基础) · 编码支持库 · 文件操作