搜索历史

清空
搜索热词
      0
      • 聊天消息
      • 系统消息
      • 评论与回复
      查看更多
      查看更多
      查看更多
      VIP于 到期 续费
      登录后你可以
      • 下载海量资料
      • 学习在线课程
      • 观看技术视频
      • 写文章/发帖/加入社区
      会员中心
      创作中心
      发布
      创作活动

      完善资料让更多小伙伴认识你，还能领取20积分哦，立即完善>

      3天内不再提示

      OpenHarmony语言基础类库【@ohos.buffer (Buffer)】

      jf_46214456 ? 来源：jf_46214456 ? 作者：jf_46214456 ? 2024-04-23 17:34 ? 次阅读
      加入交流群
      微信小助手二维码

      扫码添加小助手

      加入工程师交流群

      @ohos.buffer (Buffer)

      Buffer对象用于表示固定长度的字节序列，是专门存放二进制数据的缓存区。

      推荐使用场景： 可用于处理大量二进制数据，图片处理、文件接收上传等。

      icon-note.gif说明：

      本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

      导入模块

      import buffer from '@ohos.buffer';

      鸿蒙开发指导文档：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

      搜狗高速浏览器截图20240326151547.png

      BufferEncoding

      表示支持的编码格式类型。

      系统能力： SystemCapability.Utils.Lang

      类型说明
      'ascii'表示ascii格式。
      'utf8'表示utf8格式。
      'utf-8'表示utf8格式。
      'utf16le'表示utf16小端序格式。
      'ucs2'utf16le的别名。
      'ucs-2'utf16le的别名。
      'base64'表示base64格式。
      'base64url'表示base64url格式。
      'latin1'iso-8859-1的别名, 向下兼容ascii格式。
      'binary'表示二进制格式。
      'hex'表示十六进制格式。

      buffer.alloc

      alloc(size: number, fill?: string | Buffer | number, encoding?: BufferEncoding): Buffer

      创建一定字节长度的Buffer对象，并初始化。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      sizenumber是指定的Buffer对象长度，单位：字节。
      fillstringBuffernumber
      encoding[BufferEncoding]否编码格式（当fill为string时，才有意义）。 默认值: 'utf8'。

      返回值：

      类型说明
      Buffer返回一个Buffer对象。

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.alloc(5);
let buf2 = buffer.alloc(5, 'a');
let buf3 = buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64');

      buffer.allocUninitializedFromPool

      allocUninitializedFromPool(size: number): Buffer

      创建指定大小未被初始化的Buffer对象。内存从缓冲池分配。 创建的Buffer的内容未知，需要使用[fill]函数来初始化Buffer对象。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      sizenumber是指定的Buffer对象长度，单位：字节。

      返回值：

      类型说明
      Buffer未初始化的Buffer实例。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(10);
buf.fill(0);

      buffer.allocUninitialized

      allocUninitialized(size: number): Buffer

      创建指定大小未被初始化的Buffer实例。内存不从缓冲池分配。 创建的Buffer的内容未知，需要使用[fill]函数来初始化Buffer对象。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      sizenumber是指定的Buffer对象长度，单位：字节。

      返回值：

      类型说明
      Buffer未初始化的Buffer实例。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitialized(10);
buf.fill(0);

      buffer.byteLength

      byteLength(string: string | Buffer | TypedArray | DataView | ArrayBuffer | SharedArrayBuffer, encoding?: BufferEncoding): number

      根据不同的编码方法，返回指定字符串的字节数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      stringstringBufferTypedArray
      encoding[BufferEncoding]否编码格式。 默认值: 'utf8'。

      返回值：

      类型说明
      number返回指定字符串的字节数。

      示例：

      import buffer from '@ohos.buffer';

let str = 'u00bd + u00bc = u00be';
console.log(`${str}: ${str.length} characters, ${buffer.byteLength(str, 'utf-8')} bytes`);
// 打印: ? + ? = ?: 9 characters, 12 bytes

      buffer.compare

      compare(buf1: Buffer | Uint8Array, buf2: Buffer | Uint8Array): -1 | 0 | 1

      返回两个数组的比较结果，通常用于对Buffer对象数组进行排序。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      buf1BufferUint8Array是
      buf2BufferUint8Array是

      返回值：

      类型说明
      -10

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from('1234');
let buf2 = buffer.from('0123');
let res = buf1.compare(buf2);

console.log(Number(res).toString()); // 打印 1

      buffer.concat

      concat(list: Buffer[] | Uint8Array[], totalLength?: number): Buffer

      将数组中的内容复制指定字节长度到新的Buffer对象中并返回。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      listBuffer[]Uint8Array[]是
      totalLengthnumber否需要复制的总字节长度。

      返回值：

      类型说明
      Buffer返回新的Buffer对象。

      错误码：

      以下错误码的详细介绍请参见[[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "length" is out of range. It must be >= 0 and <= uint32 max. Received value is: [length]

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from("1234");
let buf2 = buffer.from("abcd");
let buf = buffer.concat([buf1, buf2]);
console.log(buf.toString('hex')); // 3132333461626364

      buffer.from

      from(array: number[]): Buffer;

      根据指定数组创建新的Buffer对象。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      arraynumber[]是指定数组。

      返回值：

      类型说明
      Buffer新的Buffer对象。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x62, 0x75, 0x66, 0x66, 0x65, 0x72]);
console.log(buf.toString('hex')); // 627566666572

      buffer.from

      from(arrayBuffer: ArrayBuffer | SharedArrayBuffer, byteOffset?: number, length?: number): Buffer

      创建指定长度的与arrayBuffer共享内存的Buffer对象。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      arrayBufferArrayBufferSharedArrayBuffer是
      byteOffsetnumber否字节偏移量，默认值: 0。
      lengthnumber否字节长度， 默认值: (arrayBuffer.byteLength - byteOffset)。

      返回值：

      类型说明
      Buffer返回一个共享内存的Buffer对象。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[byteOffset/length]" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let ab = new ArrayBuffer(10);
let buf = buffer.from(ab, 0, 2);

      buffer.from

      from(buffer: Buffer | Uint8Array): Buffer

      创建并复制buffer数据到新的Buffer对象并返回。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      bufferBufferUint8Array是

      返回值：

      类型说明
      Buffer新的Buffer对象。

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from('buffer');
let buf2 = buffer.from(buf1);

      buffer.from

      from(object: Object, offsetOrEncoding: number | string, length: number): Buffer

      根据指定的object类型数据，创建新的Buffer对象。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      objectObject是支持Symbol.toPrimitive或valueOf()的对象。
      offsetOrEncodingnumberstring是
      lengthnumber是字节长度。

      返回值：

      类型说明
      Buffer返回新的Buffer对象。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from(new String('this is a test'), 'utf8', 14);

      buffer.from

      from(string: String, encoding?: BufferEncoding): Buffer

      根据指定编码格式的字符串，创建新的Buffer对象。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      stringString是字符串
      encoding[BufferEncoding]否编码格式。 默认值: 'utf8'。

      返回值：

      类型说明
      Buffer返回新的Buffer对象。

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from('this is a test');
let buf2 = buffer.from('7468697320697320612074c3a97374', 'hex');

console.log(buf1.toString());	// 打印: this is a test
console.log(buf2.toString()); // 打印: this is a test

      [](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-buffer.md#bufferisbuffer)buffer.isBuffer

      isBuffer(obj: Object): boolean

      判断obj是否为Buffer。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      objObject是判断对象

      返回值：

      类型说明
      boolean如果obj是Buffer，则返回true，否则返回false。

      示例：

      import buffer from '@ohos.buffer';

let result = buffer.isBuffer(buffer.alloc(10)); // true
let result1 = buffer.isBuffer(buffer.from('foo')); // true
let result2 = buffer.isBuffer('a string'); // false
let result3 = buffer.isBuffer([]); // false
let result4 = buffer.isBuffer(new Uint8Array(1024)); // false

      buffer.isEncoding

      isEncoding(encoding: string): boolean

      判断encoding是否为支持的编码格式。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      encodingstring是编码格式。

      返回值：

      类型说明
      boolean是支持的编码格式返回true，反之则返回false。

      示例：

      import buffer from '@ohos.buffer';

console.log(buffer.isEncoding('utf-8').toString());	// 打印: true
console.log(buffer.isEncoding('hex').toString());	// 打印: true
console.log(buffer.isEncoding('utf/8').toString());	// 打印: false
console.log(buffer.isEncoding('').toString());	// 打印: false

      buffer.transcode

      transcode(source: Buffer | Uint8Array, fromEnc: string, toEnc: string): Buffer

      将给定的Buffer或Uint8Array对象从一种字符编码重新编码为另一种。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      sourceBufferUint8Array是
      fromEncstring是当前编码。
      toEncstring是目标编码。

      返回值：

      类型说明
      Buffer根据当前编码转换成目标编码，并返回一个新的buffer实例。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.alloc(50);
let newBuf = buffer.transcode(buffer.from('�'), 'utf-8', 'ascii');
console.log(newBuf.toString('ascii'));

      Buffer

      属性

      系统能力： SystemCapability.Utils.Lang

      名称类型可读可写说明
      lengthnumber是否Buffer对象的字节长度。
      bufferArrayBuffer是否ArrayBuffer对象。
      byteOffsetnumber是否当前Buffer所在内存池的偏移量。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200013Cannot set property ${propertyName} of Buffer which has only a getter.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from("1236");
console.log(JSON.stringify(buf.length));
let arrayBuffer = buf.buffer;
console.log(JSON.stringify(new Uint8Array(arrayBuffer)));
console.log(JSON.stringify(buf.byteOffset));

      compare

      compare(target: Buffer | Uint8Array, targetStart?: number, targetEnd?: number, sourceStart?: number, sourceEnd?: number): -1 | 0 | 1

      当前Buffer对象与目标Buffer对象进行比较，并返回Buffer在排序中的顺序结果。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      targetBufferUint8Array是
      targetStartnumber否target实例中开始的偏移量。 默认值: 0。
      targetEndnumber否target实例中结束的偏移量（不包含结束位置）。 默认值: 目标对象的字节长度。
      sourceStartnumber否this实例中开始的偏移量。 默认值: 0。
      sourceEndnumber否this实例中结束的偏移量（不包含结束位置）。 默认值: 当前对象的字节长度。

      返回值：

      类型说明
      number返回比较结果。-1：当前排列在目标前，0：当前与目标相同，1：当前排列在目标后。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[targetStart/targetEnd/sourceStart/sourceEnd]" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from([1, 2, 3, 4, 5, 6, 7, 8, 9]);
let buf2 = buffer.from([5, 6, 7, 8, 9, 1, 2, 3, 4]);

console.log(buf1.compare(buf2, 5, 9, 0, 4).toString());	// 打印: 0
console.log(buf1.compare(buf2, 0, 6, 4).toString());	// 打印: -1
console.log(buf1.compare(buf2, 5, 6, 5).toString());	// 打印: 1

      copy

      copy(target: Buffer| Uint8Array, targetStart?: number, sourceStart?: number, sourceEnd?: number): number

      将this实例中指定位置的数据复制到target的指定位置上，并返回复制的字节总长度。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      targetBufferUint8Array是
      targetStartnumber否target实例中开始写入的偏移量。 默认值: 0。
      sourceStartnumber否this实例中开始复制的偏移量。 默认值: 0。
      sourceEndnumber否this实例中结束复制的偏移量（不包含结束位置）。 默认值: 当前对象的字节长度。

      返回值：

      类型说明
      number复制的字节总长度。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[targetStart/sourceStart/sourceEnd]" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.allocUninitializedFromPool(26);
let buf2 = buffer.allocUninitializedFromPool(26).fill('!');

for (let i = 0; i < 26; i++) {
  buf1[i] = i + 97;
}

buf1.copy(buf2, 8, 16, 20);
console.log(buf2.toString('ascii', 0, 25));
// 打印: !!!!!!!!qrst!!!!!!!!!!!!!

      entries

      entries(): IterableIterator<[number, number]>

      返回一个包含key和value的迭代器。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      IterableIterator<[number, number]>包含key和value的迭代器，同时两者皆为number类型。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from('buffer');
for (let pair of buf.entries()) {
  console.log(pair.toString());
}

      equals

      equals(otherBuffer: Uint8Array | Buffer): boolean

      比较this实例和otherBuffer实例是否相等。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      otherBufferUint8ArrayBuffer是

      返回值：

      类型说明
      boolean相等则返回true，否则返回false。

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from('ABC');
let buf2 = buffer.from('414243', 'hex');
let buf3 = buffer.from('ABCD');

console.log(buf1.equals(buf2).toString());	// 打印: true
console.log(buf1.equals(buf3).toString());	// 打印: false

      fill

      fill(value: string | Buffer | Uint8Array | number, offset?: number, end?: number, encoding?: BufferEncoding): Buffer

      用value填充当前对象指定位置的数据，默认为循环填充，并返回填充后的Buffer对象。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuestringBufferUint8Array
      offsetnumber否起始偏移量。 默认值: 0。
      endnumber否结束偏移量（不包含结束位置）。 默认值: 当前对象的字节长度。
      encoding[BufferEncoding]否字符编码格式（value为string才有意义）。 默认值: 'utf8'。

      返回值：

      类型说明
      Buffer返回一个填充后的Buffer对象。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[offset/end]" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let b = buffer.allocUninitializedFromPool(50).fill('h');
console.log(b.toString());

      includes

      includes(value: string | number | Buffer | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): boolean

      检查Buffer对象是否包含value值。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuestringnumberBuffer
      byteOffsetnumber否字节偏移量。 如果为负数，则从末尾开始计算偏移量。 默认值: 0。
      encoding[BufferEncoding]否字符编码格式。 默认值: 'utf8'。

      返回值：

      类型说明
      boolean存在为true，否则为false。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from('this is a buffer');
console.log(buf.includes('this').toString());	// 打印: true
console.log(buf.includes('be').toString());	// 打印: false

      indexOf

      indexOf(value: string | number | Buffer | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number

      查找当前对象中第一次出现value的索引，如果不包含value，则为-1。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuestringnumberBuffer
      byteOffsetnumber否字节偏移量。 如果为负数，则从末尾开始计算偏移量。 默认值: 0。
      encoding[BufferEncoding]否字符编码格式。 默认值: 'utf8'。

      返回值：

      类型说明
      number第一次出现位置。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from('this is a buffer');
console.log(buf.indexOf('this').toString());	// 打印: 0
console.log(buf.indexOf('is').toString());		// 打印: 2

      keys

      keys(): IterableIterator

      返回一个包含key值的迭代器。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      IterableIterator返回一个包含key值的迭代器。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from('buffer');
for (const key of buf.keys()) {
  console.log(key.toString());
}

      lastIndexOf

      lastIndexOf(value: string | number | Buffer | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number

      返回this实例中最后一次出现value的索引，如果对象不包含，则为-1。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuestringnumberBuffer
      byteOffsetnumber否字节偏移量。 如果为负数，则从末尾开始计算偏移量。 默认值: 0。
      encoding[BufferEncoding])否字符编码格式。 默认值: 'utf8'。

      返回值：

      类型说明
      number最后一次出现value值的索引。

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from('this buffer is a buffer');
console.log(buf.lastIndexOf('this').toString());	// 打印: 0
console.log(buf.lastIndexOf('buffer').toString());	// 打印: 17

      readBigInt64BE

      readBigInt64BE(offset?: number): bigint

      从指定的offset处读取有符号的大端序64位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      bigint读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, 
        0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
console.log(buf.readBigInt64BE(0).toString());

let buf1 = buffer.allocUninitializedFromPool(8);
let result = buf1.writeBigInt64BE(BigInt(0x0102030405060708), 0);

      readBigInt64LE

      readBigInt64LE(offset?: number): bigint

      从指定的offset处读取有符号的小端序64位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      bigint读取出的内容。

      错误码：

      以下错误码的详细介绍请参见语言基础类库错误码。

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, 
        0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
console.log(buf.readBigInt64LE(0).toString());

let buf1 = buffer.allocUninitializedFromPool(8);
let result = buf1.writeBigInt64BE(BigInt(0x0102030405060708), 0);

      readBigUInt64BE

      readBigUInt64BE(offset?: number): bigint

      从指定的offset处读取无符号的大端序64位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      bigint读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, 
        0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
console.log(buf.readBigUInt64BE(0).toString());

let buf1 = buffer.allocUninitializedFromPool(8);
let result = buf1.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0);

      readBigUInt64LE

      readBigUInt64LE(offset?: number): bigint

      从指定的offset处读取无符号的小端序64位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      bigint读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, 
        0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
console.log(buf.readBigUInt64LE(0).toString());

let buf1 = buffer.allocUninitializedFromPool(8);
let result = buf1.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0);

      readDoubleBE

      readDoubleBE(offset?: number): number

      从指定offset处读取64位大端序双精度值。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
console.log(buf.readDoubleBE(0).toString());

let buf1 = buffer.allocUninitializedFromPool(8);
let result = buf1.writeDoubleBE(123.456, 0);

      readDoubleLE

      readDoubleLE(offset?: number): number

      从指定offset处读取64位小端序双精度值。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
console.log(buf.readDoubleLE(0).toString());

let buf1 = buffer.allocUninitializedFromPool(8);
let result = buf1.writeDoubleLE(123.456, 0);

      readFloatBE

      readFloatBE(offset?: number): number

      从指定offset处读取32位大端序浮点数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
console.log(buf.readFloatBE(0).toString());

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeFloatBE(0xcabcbcbc, 0);

      readFloatLE

      readFloatLE(offset?: number): number

      从指定offset处读取32位小端序浮点数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
console.log(buf.readFloatLE(0).toString());

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeFloatLE(0xcabcbcbc, 0);

      readInt8

      readInt8(offset?: number): number

      从指定的offset处读取有符号的8位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([-1, 5]);
console.log(buf.readInt8(0).toString());	// 打印: 0
console.log(buf.readInt8(1).toString());	// 打印: 5

let buf1 = buffer.allocUninitializedFromPool(2);
let result = buf1.writeInt8(0x12);

      readInt16BE

      readInt16BE(offset?: number): number

      从指定的offset处读取有符号的大端序16位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0, 5]);
console.log(buf.readInt16BE(0).toString());	// 打印: 5

let buf1 = buffer.alloc(2);
let result = buf1.writeInt16BE(0x1234, 0);

      readInt16LE

      readInt16LE(offset?: number): number

      从指定的offset处读取有符号的小端序16位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0, 5]);
console.log(buf.readInt16LE(0).toString());	// 打印: 1280

let buf1 = buffer.alloc(2);
let result = buf1.writeInt16BE(0x1234, 0);

      readInt32BE

      readInt32BE(offset?: number): number

      从指定的offset处读取有符号的大端序32位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0, 0, 0, 5]);
console.log(buf.readInt32BE(0).toString());	// 打印: 5

let buf1 = buffer.alloc(4);
let result = buf1.writeInt32BE(0x12345678, 0);

      readInt32LE

      readInt32LE(offset?: number): number

      从指定的offset处读取有符号的小端序32位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0, 0, 0, 5]);
console.log(buf.readInt32LE(0).toString());	// 打印: 83886080

let buf1 = buffer.alloc(4);
let result = buf1.writeInt32BE(0x12345678, 0);

      readIntBE

      readIntBE(offset: number, byteLength: number): number

      从指定的offset处的buf读取byteLength个字节，并将结果解释为支持最高48位精度的大端序、二进制补码有符号值。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber是偏移量。 默认值: 0。
      byteLengthnumber是读取的字节数。

      返回值：

      类型说明
      number读取的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from("ab");
let num = buf.readIntBE(0, 1);
console.log(num.toString()); // 97

let buf1 = buffer.allocUninitializedFromPool(6);
let result = buf1.writeIntBE(0x123456789011, 0, 6);

      readIntLE

      readIntLE(offset: number, byteLength: number): number

      从指定的offset处的buf读取byteLength个字节，并将结果解释为支持最高48位精度的小端序、二进制补码有符号值。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber是偏移量。 默认值: 0。
      byteLengthnumber是读取的字节数。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见语言基础类库错误码。

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
console.log(buf.readIntLE(0, 6).toString(16));

let buf1 = buffer.allocUninitializedFromPool(6);
let result = buf1.writeIntLE(0x123456789011, 0, 6);

      readUInt8

      readUInt8(offset?: number): number

      从offset处读取8位无符号整型数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([1, -2]);
console.log(buf.readUInt8(0).toString());
console.log(buf.readUInt8(1).toString());

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeUInt8(0x42);

      readUInt16BE

      readUInt16BE(offset?: number): number

      从指定的offset处的buf读取无符号的大端序16位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x12, 0x34, 0x56]);
console.log(buf.readUInt16BE(0).toString(16));
console.log(buf.readUInt16BE(1).toString(16));

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeUInt16BE(0x1234, 0);

      readUInt16LE

      readUInt16LE(offset?: number): number

      从指定的offset处的buf读取无符号的小端序16位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x12, 0x34, 0x56]);
console.log(buf.readUInt16LE(0).toString(16));
console.log(buf.readUInt16LE(1).toString(16));

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeUInt16LE(0x1234, 0);

      readUInt32BE

      readUInt32BE(offset?: number): number

      从指定的offset处的buf读取无符号的大端序32位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x12, 0x34, 0x56, 0x78]);
console.log(buf.readUInt32BE(0).toString(16));

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeUInt32BE(0x12345678, 0);

      readUInt32LE

      readUInt32LE(offset?: number): number

      从指定的offset处的buf读取无符号的小端序32位整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x12, 0x34, 0x56, 0x78]);
console.log(buf.readUInt32LE(0).toString(16));

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeUInt32LE(0x12345678, 0);

      readUIntBE

      readUIntBE(offset: number, byteLength: number): number

      从指定的offset处的buf读取byteLength个字节，并将结果解释为支持最高48位精度的无符号大端序整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber是偏移量。 默认值: 0。
      byteLengthnumber是要读取的字节数。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
console.log(buf.readUIntBE(0, 6).toString(16));

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeUIntBE(0x13141516, 0, 4);

      readUIntLE

      readUIntLE(offset: number, byteLength: number): number

      从指定的offset处的buf读取byteLength个字节，并将结果解释为支持最高48位精度的无符号小端序整数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      offsetnumber是偏移量。 默认值: 0。
      byteLengthnumber是要读取的字节数。

      返回值：

      类型说明
      number读取出的内容。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
console.log(buf.readUIntLE(0, 6).toString(16));

let buf1 = buffer.allocUninitializedFromPool(4);
let result = buf1.writeUIntLE(0x13141516, 0, 4);

      subarray

      subarray(start?: number, end?: number): Buffer

      截取当前对象指定位置的数据并返回。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      startnumber否截取开始位置。 默认值: 0。
      endnumber否截取结束位置（不包含结束位置）。 默认值: 当前对象的字节长度。

      返回值：

      类型说明
      Buffer返回新的Buffer对象。

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.allocUninitializedFromPool(26);

for (let i = 0; i < 26; i++) {
  buf1[i] = i + 97;
}
const buf2 = buf1.subarray(0, 3);
console.log(buf2.toString('ascii', 0, buf2.length));
// 打印: abc

      swap16

      swap16(): Buffer

      将当前对象解释为无符号的16位整数数组，并交换字节顺序。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      Buffer交换之后的Buffer实例。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200009Buffer size must be a multiple of 16-bits

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
console.log(buf1.toString('hex'));	// 打印: 0102030405060708

buf1.swap16();
console.log(buf1.toString('hex'));	// 打印: 0201040306050807

      swap32

      swap32(): Buffer

      将当前对象解释为无符号的32位整数数组，并交换字节顺序。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      Buffer交换之后的Buffer对象。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200009Buffer size must be a multiple of 32-bits

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
console.log(buf1.toString('hex'));	// 打印: 0102030405060708

buf1.swap32();
console.log(buf1.toString('hex'));	// 打印: 0403020108070605

      swap64

      swap64(): Buffer

      将当前对象解释为无符号的64位整数数组，并交换字节顺序。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      Buffer交换之后的Buffer对象。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200009Buffer size must be a multiple of 64-bits

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
console.log(buf1.toString('hex'));	// 打印: 0102030405060708
buf1.swap64();
console.log(buf1.toString('hex'));	// 打印: 0807060504030201

      toJSON

      toJSON(): Object

      将Buffer转为JSON并返回。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      ObjectJSON对象。

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5]);
let obj = buf1.toJSON();
console.log(JSON.stringify(obj));
// 打印: {"type":"Buffer","data":[1,2,3,4,5]}

      toString

      toString(encoding?: string, start?: number, end?: number): string

      将当前对象中指定位置数据转成指定编码格式字符串并返回。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      encodingstring否字符编码格式。 默认值: 'utf8'。
      startnumber否开始位置。 默认值: 0。
      endnumber否结束位置。 默认值: Buffer.length。

      返回值：

      类型说明
      string字符串。

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.allocUninitializedFromPool(26);
for (let i = 0; i < 26; i++) {
  buf1[i] = i + 97;
}
console.log(buf1.toString('utf-8'));
// 打印: abcdefghijklmnopqrstuvwxyz

      values

      values(): IterableIterator

      返回一个包含value的迭代器。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      IterableIterator迭代器。

      示例：

      import buffer from '@ohos.buffer';

let buf1 = buffer.from('buffer');
for (let value of buf1.values()) {
  console.log(value.toString());
}

      write

      write(str: string, offset?: number, length?: number, encoding?: string): number

      从Buffer对象的offset偏移写入指定编码的字符串str，写入的字节长度为length。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      strstring是要写入Buffer的字符串。
      offsetnumber否偏移量。 默认值: 0。
      lengthnumber否最大字节长度。 默认值: (Buffer.length - offset)。
      encodingstring否字符编码。 默认值: 'utf8'。

      返回值：

      类型说明
      number返回写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[offset/length]" is out of range.

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.alloc(256);
let len = buf.write('u00bd + u00bc = u00be', 0);
console.log(`${len} bytes: ${buf.toString('utf-8', 0, len)}`);
// 打印: 12 bytes: ? + ? = ?

let buffer1 = buffer.alloc(10);
let length = buffer1.write('abcd', 8);

      writeBigInt64BE

      writeBigInt64BE(value: bigint, offset?: number): number

      从Buffer对象的offset偏移写入有符号的大端序64位BigInt型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuebigint是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(8);
let result = buf.writeBigInt64BE(BigInt(0x0102030405060708), 0);

      writeBigInt64LE

      writeBigInt64LE(value: bigint, offset?: number): number

      从Buffer对象的offset偏移写入有符号的小端序64位BigInt型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuebigint是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(8);
let result = buf.writeBigInt64LE(BigInt(0x0102030405060708), 0);

      writeBigUInt64BE

      writeBigUInt64BE(value: bigint, offset?: number): number

      从Buffer对象的offset偏移写入无符号的大端序64位BigUInt型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuebigint是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(8);
let result = buf.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0);

      writeBigUInt64LE

      writeBigUInt64LE(value: bigint, offset?: number): number

      从Buffer对象的offset偏移写入无符号的小端序64位BigUInt型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuebigint是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(8);
let result = buf.writeBigUInt64LE(BigInt(0xdecafafecacefade), 0);

      writeDoubleBE

      writeDoubleBE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入大端序的64位双浮点型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见语言基础类库错误码。

      错误码ID错误信息
      10200001The value of "offset" is out of range. It must be >= 0 and <= buf.length - 8. Received value is: [offset]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(8);
let result = buf.writeDoubleBE(123.456, 0);

      writeDoubleLE

      writeDoubleLE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入小端序的64位双浮点型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见语言基础类库错误码。

      错误码ID错误信息
      10200001The value of "offset" is out of range. It must be >= 0 and <= buf.length - 8. Received value is: [offset]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(8);
let result = buf.writeDoubleLE(123.456, 0);

      writeFloatBE

      writeFloatBE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入大端序的32位浮点型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range. It must be >= 0 and <= buf.length - 4. Received value is: [offset]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(8);
let result = buf.writeFloatBE(0xcafebabe, 0);

      writeFloatLE

      writeFloatLE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入小端序的32位浮点型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "offset" is out of range. It must be >= 0 and <= buf.length - 4. Received value is: [offset]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(8);
let result = buf.writeFloatLE(0xcafebabe, 0);

      writeInt8

      writeInt8(value: number, offset?: number): number

      从Buffer对象的offset偏移写入8位有符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(2);
let result = buf.writeInt8(2, 0);
let result1 = buf.writeInt8(-2, 1);

      writeInt16BE

      writeInt16BE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入大端序的16位有符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(2);
let result = buf.writeInt16BE(0x0102, 0);

      writeInt16LE

      writeInt16LE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入小端序的16位有符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(2);
let result = buf.writeInt16LE(0x0304, 0);

      writeInt32BE

      writeInt32BE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入大端序的32位有符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(4);
let result = buf.writeInt32BE(0x01020304, 0);

      writeInt32LE

      writeInt32LE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入小端序的32位有符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(4);
let result = buf.writeInt32LE(0x05060708, 0);

      writeIntBE

      writeIntBE(value: number, offset: number, byteLength: number): number

      从Buffer对象的offset偏移写入大端序的有符号value数据，value字节长度为byteLength。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber是偏移量。 默认值: 0。
      byteLengthnumber是要写入的字节数。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(6);
let result = buf.writeIntBE(0x1234567890ab, 0, 6);

      writeIntLE

      writeIntLE(value: number, offset: number, byteLength: number): number

      从Buffer对象的offset偏移写入小端序的有符号value数据，value字节长度为byteLength。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber是偏移量。 默认值: 0。
      byteLengthnumber是要写入的字节数。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(6);
let result = buf.writeIntLE(0x1234567890ab, 0, 6);

      writeUInt8

      writeUInt8(value: number, offset?: number): number

      从Buffer对象的offset偏移写入8位无符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(4);
let result = buf.writeUInt8(0x3, 0);
let result1 = buf.writeUInt8(0x4, 1);
let result2 = buf.writeUInt8(0x23, 2);
let result3 = buf.writeUInt8(0x42, 3);

      writeUInt16BE

      writeUInt16BE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入大端序的16位无符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值为0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(4);
let result = buf.writeUInt16BE(0xdead, 0);
let result1 = buf.writeUInt16BE(0xbeef, 2);

      writeUInt16LE

      writeUInt16LE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入小端序的16位无符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(4);
let result = buf.writeUInt16LE(0xdead, 0);
let result1 = buf.writeUInt16LE(0xbeef, 2);

      writeUInt32BE

      writeUInt32BE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入大端序的32位无符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(4);
let result = buf.writeUInt32BE(0xfeedface, 0);

      writeUInt32LE

      writeUInt32LE(value: number, offset?: number): number

      从Buffer对象的offset偏移写入小端序的32位无符号整型数据value。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer对象的数字。
      offsetnumber否偏移量。 默认值: 0。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(4);
let result = buf.writeUInt32LE(0xfeedface, 0);

      writeUIntBE

      writeUIntBE(value: number, offset: number, byteLength: number): number

      从Buffer对象的offset偏移写入大端序的无符号value数据，value字节长度为byteLength。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber是偏移量。 默认值: 0。
      byteLengthnumber是要写入的字节数。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(6);
let result = buf.writeUIntBE(0x1234567890ab, 0, 6);

      writeUIntLE

      writeUIntLE(value: number, offset: number, byteLength: number): number

      从Buffer对象的offset偏移写入小端序的无符号value数据，value字节长度为byteLength。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      valuenumber是写入Buffer的数据。
      offsetnumber是偏移量。 默认值: 0。
      byteLengthnumber是要写入的字节数。

      返回值：

      类型说明
      number写入的字节数。

      错误码：

      以下错误码的详细介绍请参见[语言基础类库错误码]

      错误码ID错误信息
      10200001The value of "[param]" is out of range. It must be >= [left range] and <= [right range]. Received value is: [param]

      示例：

      import buffer from '@ohos.buffer';

let buf = buffer.allocUninitializedFromPool(6);
let result = buf.writeUIntLE(0x1234567890ab, 0, 6);

      Blob

      属性

      系统能力： SystemCapability.Utils.Lang

      名称类型可读可写说明
      sizenumber是否Blob实例的总字节大小。
      typestring是否Blob实例的内容类型。

      constructor

      constructor(sources: string[] | ArrayBuffer[] | TypedArray[] | DataView[] | Blob[] , options?: Object)

      Blob的构造函数。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      sourcesstring[]ArrayBuffer[]TypedArray[]
      optionsObject否options: - endings:含义为结束符'n'的字符串如何被输出，为'transparent'或'native'。native代表行结束符会跟随系统。'transparent'代表会保持Blob中保存的结束符不变。此参数非必填，默认值为'transparent'。 - type:Blob内容类型。其目的是让类型传达数据的MIME媒体类型，但是不执行类型格式的验证。此参数非必填，默认参数为''。

      示例：

      import buffer from '@ohos.buffer';

let blob = new buffer.Blob(['a', 'b', 'c']);
let blob1 = new buffer.Blob(['a', 'b', 'c'], {endings:'native', type: 'MIME'});

      arrayBuffer

      arrayBuffer(): Promise

      将Blob中的数据放入到ArrayBuffer中，并返回一个Promise。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      PromisePromise对象，返回包含Blob数据的ArrayBuffer。

      示例：

      let blob = new buffer.Blob(['a', 'b', 'c']);
let pro = blob.arrayBuffer();
pro.then(val = > {
  let uintarr = new Uint8Array(val);
  console.log(uintarr.toString());
});

      slice

      slice(start?: number, end?: number, type?: string): Blob

      创建并返回一个复制原Blob对象中指定数据长度的Blob新对象。

      系统能力： SystemCapability.Utils.Lang

      参数：

      参数名类型必填说明
      startnumber否起始位置。默认值为0。
      endnumber否结束位置。默认值为原Blob对象中的数据长度。
      typestring否内容类型。默认值为''。

      返回值：

      类型说明
      Blob新的Blob实例对象。

      示例：

      let blob = new buffer.Blob(['a', 'b', 'c']);
let blob2 = blob.slice(0, 2);
let blob3 = blob.slice(0, 2, "MIME");

      text

      text(): Promise

      使用UTF8进行解码并返回一个文本。使用Promise异步回调。

      系统能力： SystemCapability.Utils.Lang

      返回值：

      类型说明
      PromisePromise对象，返回包含以UTF8解码的文本。

      示例：

      let blob = new buffer.Blob(['a', 'b', 'c']);
let pro = blob.text();
pro.then(val = > {
    console.log(val);
});

      审核编辑 黄宇

      声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉
      • 鸿蒙
        鸿蒙
        +关注

        关注

        60

        文章

        2643

        浏览量

        44240
      • OpenHarmony
        OpenHarmony
        +关注

        关注

        30

        文章

        3858

        浏览量

        18789
      收藏 人收藏
      加入交流群
      微信小助手二维码

      扫码添加小助手

      加入工程师交流群

        评论

        相关推荐
        热点推荐

        什么是always on buffer？什么情况下需要插always on buffer？

        相比普通的buffer cell，always on buffer（AOB）有secondary always on pin，可以让AOB即使在primary power off的情况下保持on的状态；AOB在secondary pg pin off的情况下也是off的。
        的头像 发表于 12-01 15:31 ?4209次阅读
        什么是always on <b class='flag-5'>buffer</b>？什么情况下需要插always on <b class='flag-5'>buffer</b>？

        什么是Protocol Buffer

        一 什么是Protocol BufferProtocol Buffer是一种支持多平台、多语言、可扩展的的数据序列化机制，相较于XML来说，protobuf更小更快更简单，支持自定义的数据结构，用
        发表于 11-30 08:00

        快速buffer添加算法

        在深亚微米设计中，连线延迟时间已经超过器件延迟时间，成为影响性能的瓶颈之一。在线网中插入缓冲器（buffer）是改善线延迟的一种有效方法，但是目前基于缓冲器块（buffer bloc
        发表于 12-14 10:28 ?6次下载

        PCIe Clock Buffer-Generator-Si

        PCIe Clock Buffer : PI6C20800: 1:8 PCIe 100 MHz DifferentialHCSL Clock Buffer View Datasheet |
        发表于 04-01 14:59 ?3199次阅读

        什么是buffer

        什么是buffer  英文缩写: buffer 中文译名: 缓冲，缓冲器 分　　类: 电信设备 解　　释: 在数据传输中，用来
        发表于 02-22 11:11 ?6355次阅读

        基于串行RapidIO的Buffer层设计

        基于串行RapidIO的Buffer层设计_任雪倩
        发表于 01-07 21:28 ?0次下载

        wideband buffer amplifiers

        wideband buffer amplifiers
        发表于 03-24 14:49 ?0次下载

        linux内存的使用与page buffer有什么联系？

        系统要于磁盘打交道，必须先分配一个page buffer：当需要读入文件时，首先要查找address_space看是否已经存在page_buffer，没有的话则分配一个page buffer页框，插入address_space。
        发表于 05-13 11:46 ?1628次阅读

        Ring buffer介绍

        的头和尾，添加和消费消息一类的东西。所有这些东西我还没有在 Ring Buffer 一节真正提到。这是因为 Ring Buffer 本身并不负责这些事情，我们把这些问题挪到了数据结构的外部。
        发表于 04-02 14:32 ?3441次阅读

        Protocol Buffer在MCU上的实现--C语言

        一 什么是Protocol BufferProtocol Buffer是一种支持多平台、多语言、可扩展的的数据序列化机制，相较于XML来说，protobuf更小更快更简单，支持自定义的数据结构，用
        发表于 11-20 13:21 ?10次下载
        Protocol <b class='flag-5'>Buffer</b>在MCU上的实现--C<b class='flag-5'>语言</b>

        基于openharmony移植的ohos拼图支持库

        项目介绍 项目名称：PuzzleView 所属系列：openharmony的第三方组件适配移植 功能：ohos拼图支持库 项目移植状态：主功能完成，由于ohos暂不支持，所以分享功能暂
        发表于 03-22 11:24 ?2次下载

        BPF ring buffer解决的问题及背后的设计

        文章介绍了 BPF ring buffer 解决的问题及背后的设计，并给出了一些代码示例和内核 patch 链接，深度和广度兼备，是学习 ring buffer 的极佳参考。
        的头像 发表于 05-17 09:37 ?2694次阅读

        什么是时钟缓冲器（Buffer）？时钟缓冲器（Buffer）参数解析

        什么是时钟缓冲器（Buffer）？时钟缓冲器（Buffer）参数解析 什么是时钟缓冲器（Buffer）？我们先把这个概念搞清楚。 时钟缓冲器就是常说的Clock Buffer，通常是指
        发表于 10-18 18:36 ?2.9w次阅读
        什么是时钟缓冲器（<b class='flag-5'>Buffer</b>）？时钟缓冲器（<b class='flag-5'>Buffer</b>）参数解析

        IC设计中Buffer的作用有哪些？

        首先了解一下buffer是什么，buffer中文名称缓冲器，属于逻辑和电压转换分类，主要目的用于增强系统中的信号完整性。
        发表于 06-05 15:55 ?1.8w次阅读

        鸿蒙OpenHarmony大合集：【语言基础类库】

        本示例集合语言基础类库的各个子模块，展示了各个模块的基础功能
        的头像 发表于 04-29 16:38 ?908次阅读
        鸿蒙<b class='flag-5'>OpenHarmony</b>大合集：【<b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>】
        abg欧博（原“华强聚丰”）：
        电子发烧友
        abg欧博开发
        abg欧博电路(原"华强PCB")
        abg欧博商城(原"华强芯城")
        abg欧博智造
        My ElecFans
        APP
        网站地图
        设计技术
        可编程逻辑
        电源/新能源
        MEMS/传感技术
        测量仪表
        嵌入式技术
        制造/封装
        模拟技术
        RF/无线
        接口/总线/驱动
        处理器/DSP
        EDA/IC设计
        存储技术
        光电显示
        EMC/EMI设计
        连接器
        行业应用
        LEDs
        汽车电子
        音视频及家电
        通信网络
        医疗电子
        人工智能
        虚拟现实
        可穿戴设备
        机器人
        安全设备/系统
        军用/航空电子
        移动通信
        工业控制
        便携设备
        触控感测
        物联网
        智能电网
        区块链
        新科技
        特色内容
        专栏推荐
        学院
        设计资源
        设计技术
        电子百科
        电子视频
        元器件知识
        工具箱
        VIP会员
        最新技术文章
        产品地图
        品牌地图
        社区
        小组
        论坛
        问答
        评测试用
        企业服务
        产品
        资料
        文章
        方案
        企业
        供应链服务
        硬件开发
        abg欧博电路
        abg欧博商城
        abg欧博智造
        nextPCB
        BOM配单
        媒体服务
        网站广告
        在线研讨会
        活动策划
        新闻发布
        新品发布
        小测验
        设计大赛
        abg欧博
        关于我们
        投资关系
        新闻动态
        加入我们
        联系我们
        举报投诉
        社交网络
        微博
        移动端
        发烧友APP
        硬声APP
        WAP
        联系我们
        广告合作
        王婉珠：wangwanzhu@elecfans.com
        内容合作
        黄晶晶：huangjingjing@elecfans.com
        内容合作（海外）
        张迎辉：mikezhang@elecfans.com
        供应链服务 PCB/IC/PCBA
        江良华：lanhu@huaqiu.com
        投资合作
        曾海银：zenghaiyin@huaqiu.com
        社区合作
        刘勇：liuyong@huaqiu.com

        • 关注我们的微信

          关注我们的微信

        • 下载发烧友APP

          下载发烧友APP

        • 电子发烧友观察

          电子发烧友观察
        abg欧博发烧友
        电子工程师社区
        abg欧博电路
        1-32层PCB打样·中小批量
        abg欧博商城
        元器件现货·全球代购·SmartBOM
        abg欧博智造
        SMT贴片·PCBA加工
        NextPCB
        PCB Manufacturer

        版权所有 ? 湖南abg欧博数字科技有限公司

        长沙市望城经济技术开发区航空路6号手机智能终端产业园2号厂房3层（0731-88081133）

        电子发烧友 （电路图） 湘公网安备43011202000918 工商网监认证工商网监 湘ICP备2023018690号-1