Node.js

[iidear]

Buffer

https://nodejs.org/docs/latest-v14.x/api/buffer.html

Buffer 用于表示一段固定长度的 bytes 序列。

• 提供了便捷的数值读写转换方法
• 提供了便捷的字符串读写转换方法
• 以类数组的操作读写访问二进制数据

字符编码

Nodejs 支持的字符编码：

• utf8、utf16le、latin1
• base64、hex、ascii
• binary（Alias for latin1）、ucs2（Alias of utf16le）

Int8、Int16、Int32、Int64、BE、LE

• 数据类型
  • Int：整型
  • UInt：无符号整型
  • Float：浮点型
  • Double：双精度浮点型
• 存储单元
  • bit：1 个二进制位
  • byte：8 个二进制位

• 大端模式与小端模式

  • BE（Big-Endian）：大端模式，数据的高字节保存在内存的低地址中，而数据的低字节保存在内存的高地址中。
  • LE（Little-Endian）：小端模式，数据的高字节保存在内存的高地址中，而数据的低字节保存在内存的低地址中。

  const buf = Buffer.from([0b00000000, 0b00001111]);
  // 以大端模式读取 16 位整型数值
  buf.readInt16BE(); // 15, 即 0b0000000000001111
  // 以小端模式读取 16 位整型数值
  buf.readInt16LE(); // 3840, 即 0b0000111100000000

Int8 表示以 8 个 bit 存储的整型数值。Int16 表示以 16 个 bit 存储的整型数值。Int32、Int64 以此类推。

Buffer 相关操作

注：Buffer为 Nodejs 全局对象，buf为 Buffer 实例对象，buffer为 Buffer 模块的 export 对象。

• create

  • Buffer.alloc(size[, fill[, encoding]])
  • Buffer.allocUnsafe(size)
  • Buffer.allocUnsafeSlow(size)
  • Buffer.from(array)
  • Buffer.from(arrayBuffer[, byteOffset[, length]])
  • Buffer.from(buffer)
  • Buffer.from(object[, offsetOrEncoding[, length]])
  • Buffer.from(string[, encoding])

• write

  • 填充二进制内容：buf.fill(value[, offset[, end]][, encoding])
  • 写入字符串：buf.write(string[, offset[, length]][, encoding])
  • 数值转换与写入：
  • buf.writeBigInt64BE(value[, offset])
  • buf.writeBigInt64LE(value[, offset])
  • buf.writeBigUInt64BE(value[, offset])
  • buf.writeBigUInt64LE(value[, offset])
  • buf.writeDoubleBE(value[, offset])
  • buf.writeDoubleLE(value[, offset])
  • buf.writeFloatBE(value[, offset])
  • buf.writeFloatLE(value[, offset])
  • buf.writeInt8(value[, offset])
  • buf.writeInt16BE(value[, offset])
  • buf.writeInt16LE(value[, offset])
  • buf.writeInt32BE(value[, offset])
  • buf.writeInt32LE(value[, offset])
  • buf.writeIntBE(value, offset, byteLength)
  • buf.writeIntLE(value, offset, byteLength)
  • buf.writeUInt8(value[, offset])
  • buf.writeUInt16BE(value[, offset])
  • buf.writeUInt16LE(value[, offset])
  • buf.writeUInt32BE(value[, offset])
  • buf.writeUInt32LE(value[, offset])
  • buf.writeUIntBE(value, offset, byteLength)
  • buf.writeUIntLE(value, offset, byteLength)

• read

  • 读取 buf 某索引位置的内容：buf[index]
  • 读取 buf 底层的 ArrayBuffer 对象：buf.buffer
  • 读取 buf 在底层的 ArrayBuffer 上的偏移量：buf.byteOffset（buf 初始化时会先初始化 Buffer.poolSize 大小的 ArrayBuffer 用于存储 buf 数据，buf.byteOffset 用于标识 buf 在 ArrayBuffer 中的起始位置）
  • 数值转换与读取：
  • buf.readBigInt64BE([offset])
  • buf.readBigInt64LE([offset])
  • buf.readBigUInt64BE([offset])
  • buf.readBigUInt64LE([offset])
  • buf.readDoubleBE([offset])
  • buf.readDoubleLE([offset])
  • buf.readFloatBE([offset])
  • buf.readFloatLE([offset])
  • buf.readInt8([offset])
  • buf.readInt16BE([offset])
  • buf.readInt16LE([offset])
  • buf.readInt32BE([offset])
  • buf.readInt32LE([offset])
  • buf.readIntBE(offset, byteLength)
  • buf.readIntLE(offset, byteLength
  • buf.readUInt8([offset])
  • buf.readUInt16BE([offset])
  • buf.readUInt16LE([offset])
  • buf.readUInt32BE([offset])
  • buf.readUInt32LE([offset])
  • buf.readUIntBE(offset, byteLength)
  • buf.readUIntLE(offset, byteLength)

• 运算

  • 获取字符串对应的 byte 长度：Buffer.byteLength(string[, encoding])
  • 比较：
  • Buffer.compare(buf1, buf2)
  • buf.compare(target[, targetStart[, targetEnd[, sourceStart[, sourceEnd]]]])
  • 拼接：Buffer.concat(list[, totalLength])
  • 拷贝：buf.copy(target[, targetStart[, sourceStart[, sourceEnd]]])
  • 类型判断：Buffer.isBuffer(obj)
  • 是否是支持的字符编码类型：Buffer.isEncoding(encoding)
  • 数据转换支持迭代：
  • buf.entries()
  • buf.keys()
  • buf.values()
  • 相等比较：buf.equals(otherBuffer)
  • 检测包含：buf.includes(value[, byteOffset][, encoding])
  • 查询索引：
  • buf.indexOf(value[, byteOffset][, encoding])
  • buf.lastIndexOf(value[, byteOffset][, encoding])
  • buf 长度：
  • buf.length
  • 引用子数组(共享内存)：
  • buf.subarray([start[, end]])
  • buf.slice([start[, end]])
  • 大小端转换：
  • buf.swap16()
  • buf.swap32()
  • buf.swap64()
  • 字符串转换：
  • buf.toJSON()
  • buf.toString([encoding[, start[, end]]])
  • 字符串编码转换：
  • buffer.transcode(source, fromEnc, toEnc)