codecamp

二进制数据的缓存区

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

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

说明

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

导入模块

  1. import buffer from '@ohos.buffer';

BufferEncoding

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

系统能力: SystemCapability.Utils.Lang

类型

说明

'ascii'

表示ascii格式。

'utf8'

表示utf8格式。

'utf-8'

表示utf8格式。

'utf16le'

表示utf16小端序格式。

'ucs2'

utf16le的别名。

'ucs-2'

utf16le的别名。

'base64'

表示base64格式。

'base64url'

表示base64url格式。

'latin1'

表示ascii格式。

'binary'

表示二进制格式。

'hex'

表示十六进制格式。

buffer.alloc

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

size

number

指定的Buffer对象长度,单位:字节。

fill

string | Buffer | number

填充至新缓存区的值,默认值: 0。

encoding

BufferEncoding

编码格式(当fill为string时,才有意义)。 默认值: 'utf8'。

返回值:

类型

说明

Buffer

返回一个Buffer对象。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.alloc(5);
  3. let buf2 = buffer.alloc(5, 'a');
  4. let buf3 = buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64');

buffer.allocUninitializedFromPool

allocUninitializedFromPool(size: number): Buffer

创建指定大小未被初始化的Buffer对象。内存从缓冲池分配。

创建的Buffer的内容未知,需要使用fill函数来初始化Buffer对象。

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

size

number

指定的Buffer对象长度,单位:字节。

返回值:

类型

说明

Buffer

未初始化的Buffer实例。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(10);
  3. buf.fill(0);

buffer.allocUninitialized

allocUninitialized(size: number): Buffer

创建指定大小未被初始化的Buffer实例。内存不从缓冲池分配。

创建的Buffer的内容未知,需要使用fill函数来初始化Buffer对象。

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

size

number

指定的Buffer对象长度,单位:字节。

返回值:

类型

说明

Buffer

未初始化的Buffer实例。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitialized(10);
  3. buf.fill(0);

buffer.byteLength

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

string

string | Buffer | TypedArray | DataView | ArrayBuffer | SharedArrayBuffer

指定字符串。

encoding

BufferEncoding

编码格式。 默认值: 'utf8'。

返回值:

类型

说明

number

返回指定字符串的字节数。

示例:

  1. import buffer from '@ohos.buffer';
  2. let str = '\u00bd + \u00bc = \u00be';
  3. console.log(`${str}: ${str.length} characters, ${buffer.byteLength(str, 'utf-8')} bytes`);
  4. // 打印: ½ + ¼ = ¾: 9 characters, 12 bytes

buffer.compare

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

buf1

Buffer | Uint8Array

待比较数组。

buf2

Buffer | Uint8Array

待比较数组。

返回值:

类型

说明

-1 | 0 | 1

如果buf1与buf2相同,则返回0。

如果排序时buf1位于buf2之后,则返回1。

如果排序时buf1位于buf2之前,则返回-1。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from('1234');
  3. let buf2 = buffer.from('0123');
  4. let res = buf1.compare(buf2);
  5. console.log(Number(res).toString()); // 打印 1

buffer.concat

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

list

Buffer[] | Uint8Array[]

实例数组。

totalLength

number

需要复制的总字节长度。

返回值:

类型

说明

Buffer

返回新的Buffer对象。

错误码:

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

错误码ID

错误信息

10200001

The value of "totalLength" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from("1234");
  3. let buf2 = buffer.from("abcd");
  4. let buf = buffer.concat([buf1, buf2]);
  5. console.log(buf.toString('hex')); // 3132333461626364

buffer.from

from(array: number[]): Buffer;

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

array

number[]

指定数组。

返回值:

类型

说明

Buffer

新的Buffer对象。

示例:

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

buffer.from

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

arrayBuffer

ArrayBuffer | SharedArrayBuffer

实例对象。

byteOffset

number

字节偏移量,默认值: 0。

length

number

字节长度, 默认值: (arrayBuffer.byteLength - byteOffset)。

返回值:

类型

说明

Buffer

返回一个共享内存的Buffer对象。

错误码:

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

错误码ID

错误信息

10200001

The value of "[byteOffset/length]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let ab = new ArrayBuffer(10);
  3. let buf = buffer.from(ab, 0, 2);

buffer.from

from(buffer: Buffer | Uint8Array): Buffer

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

buffer

Buffer | Uint8Array

对象数据。

返回值:

类型

说明

Buffer

新的Buffer对象。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from('buffer');
  3. let buf2 = buffer.from(buf1);

buffer.from

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

object

Object

支持Symbol.toPrimitive或valueOf()的对象。

offsetOrEncoding

number | string

字节偏移量或编码格式。

length

number

字节长度。

返回值:

类型

说明

Buffer

返回新的Buffer对象。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from(new String('this is a test'), 'utf8', 14);

buffer.from

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

string

String

字符串

encoding

BufferEncoding

编码格式。 默认值: 'utf8'。

返回值:

类型

说明

Buffer

返回新的Buffer对象。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from('this is a test');
  3. let buf2 = buffer.from('7468697320697320612074c3a97374', 'hex');
  4. console.log(buf1.toString()); // 打印: this is a test
  5. console.log(buf2.toString()); // 打印: this is a test

buffer.isBuffer

isBuffer(obj: Object): boolean

判断obj是否为Buffer。

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

obj

Object

判断对象

返回值:

类型

说明

boolean

如果obj是Buffer,则返回true,否则返回false。

示例:

  1. import buffer from '@ohos.buffer';
  2. buffer.isBuffer(buffer.alloc(10)); // true
  3. buffer.isBuffer(buffer.from('foo')); // true
  4. buffer.isBuffer('a string'); // false
  5. buffer.isBuffer([]); // false
  6. buffer.isBuffer(new Uint8Array(1024)); // false

buffer.isEncoding

isEncoding(encoding: string): boolean

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

encoding

string

编码格式。

返回值:

类型

说明

boolean

是支持的编码格式返回true,反之则返回false。

示例:

  1. import buffer from '@ohos.buffer';
  2. console.log(buffer.isEncoding('utf-8').toString()); // 打印: true
  3. console.log(buffer.isEncoding('hex').toString()); // 打印: true
  4. console.log(buffer.isEncoding('utf/8').toString()); // 打印: false
  5. console.log(buffer.isEncoding('').toString()); // 打印: false

buffer.transcode

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

source

Buffer | Uint8Array

实例对象。

fromEnc

string

当前编码。

toEnc

string

目标编码。

返回值:

类型

说明

Buffer

根据当前编码转换成目标编码,并返回一个新的buffer实例。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.alloc(50);
  3. let newBuf = buffer.transcode(buffer.from('€'), 'utf-8', 'ascii');
  4. console.log(newBuf.toString('ascii'));

Buffer

属性

系统能力: SystemCapability.Utils.Lang

名称

类型

可读

可写

说明

length

number

Buffer对象的字节长度。

buffer

ArrayBuffer

ArrayBuffer对象。

byteOffset

number

当前Buffer所在内存池的偏移量。

错误码:

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

错误码ID

错误信息

10200013

Cannot set property ${propertyName} of Buffer which has only a getter.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from("1236");
  3. console.log(JSON.stringify(buf.length));
  4. let arrayBuffer = buf.buffer;
  5. console.log(JSON.stringify(new Uint8Array(arrayBuffer)));
  6. 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

参数:

参数名

类型

必填

说明

target

Buffer | Uint8Array

要比较的实例对象。

targetStart

number

target实例中开始的偏移量。 默认值: 0。

targetEnd

number

target实例中结束的偏移量(不包含结束位置)。 默认值: 目标对象的字节长度。

sourceStart

number

this实例中开始的偏移量。 默认值: 0。

sourceEnd

number

this实例中结束的偏移量(不包含结束位置)。 默认值: 当前对象的字节长度。

返回值:

类型

说明

number

返回比较结果。-1:当前排列在目标前,0:当前与目标相同,1:当前排列在目标后。

错误码:

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

错误码ID

错误信息

10200001

The value of "[targetStart/targetEnd/sourceStart/sourceEnd]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from([1, 2, 3, 4, 5, 6, 7, 8, 9]);
  3. let buf2 = buffer.from([5, 6, 7, 8, 9, 1, 2, 3, 4]);
  4. console.log(buf1.compare(buf2, 5, 9, 0, 4).toString()); // 打印: 0
  5. console.log(buf1.compare(buf2, 0, 6, 4).toString()); // 打印: -1
  6. 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

参数:

参数名

类型

必填

说明

target

Buffer | Uint8Array

要复制到的Buffer或Uint8Array实例。

targetStart

number

target实例中开始写入的偏移量。 默认值: 0。

sourceStart

number

this实例中开始复制的偏移量。 默认值: 0。

sourceEnd

number

this实例中结束复制的偏移量(不包含结束位置)。 默认值: 当前对象的字节长度。

返回值:

类型

说明

number

复制的字节总长度。

错误码:

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

错误码ID

错误信息

10200001

The value of "[targetStart/sourceStart/sourceEnd]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.allocUninitializedFromPool(26);
  3. let buf2 = buffer.allocUninitializedFromPool(26).fill('!');
  4. for (let i = 0; i < 26; i++) {
  5. buf1[i] = i + 97;
  6. }
  7. buf1.copy(buf2, 8, 16, 20);
  8. console.log(buf2.toString('ascii', 0, 25));
  9. // 打印: !!!!!!!!qrst!!!!!!!!!!!!!

entries

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

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

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

number

表示迭代器的key值。

number

表示迭代器的value值。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from('buffer');
  3. for (let pair of buf.entries()) {
  4. console.log(pair.toString());
  5. }

equals

equals(otherBuffer: Uint8Array | Buffer): boolean

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

otherBuffer

Uint8Array | Buffer

比较的目标对象。

返回值:

类型

说明

boolean

相等则返回true,否则返回false。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from('ABC');
  3. let buf2 = buffer.from('414243', 'hex');
  4. let buf3 = buffer.from('ABCD');
  5. console.log(buf1.equals(buf2).toString()); // 打印: true
  6. 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

参数:

参数名

类型

必填

说明

value

string | Buffer | Uint8Array | number

用于填充的值。

offset

number

起始偏移量。 默认值: 0。

end

number

结束偏移量(不包含结束位置)。 默认值: 当前对象的字节长度。

encoding

BufferEncoding

字符编码格式(value为string才有意义)。 默认值: 'utf8'。

返回值:

类型

说明

Buffer

返回一个填充后的Buffer对象。

错误码:

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

错误码ID

错误信息

10200001

The value of "[offset/end]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let b = buffer.allocUninitializedFromPool(50).fill('h');
  3. console.log(b.toString());

includes

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

string | number | Buffer | Uint8Array

要搜索的内容。

byteOffset

number

字节偏移量。 如果为负数,则从末尾开始计算偏移量。 默认值: 0。

encoding

BufferEncoding

字符编码格式。 默认值: 'utf8'。

返回值:

类型

说明

boolean

存在为true,否则为false。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from('this is a buffer');
  3. console.log(buf.includes('this').toString()); // 打印: true
  4. 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

参数:

参数名

类型

必填

说明

value

string | number | Buffer | Uint8Array

要查找的内容。

byteOffset

number

字节偏移量。 如果为负数,则从末尾开始计算偏移量。 默认值: 0。

encoding

BufferEncoding

字符编码格式。 默认值: 'utf8'。

返回值:

类型

说明

number

第一次出现位置。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from('this is a buffer');
  3. console.log(buf.indexOf('this').toString()); // 打印: 0
  4. console.log(buf.indexOf('is').toString()); // 打印: 2

keys

keys(): IterableIterator<number>

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

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

IterableIterator<number>

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

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from('buffer');
  3. for (const key of buf.keys()) {
  4. console.log(key.toString());
  5. }

lastIndexOf

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

string | number | Buffer | Uint8Array

要搜索的内容。

byteOffset

number

字节偏移量。 如果为负数,则从末尾开始计算偏移量。 默认值: 0。

encoding

BufferEncoding

字符编码格式。 默认值: 'utf8'。

返回值:

类型

说明

number

最后一次出现value值的索引。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from('this buffer is a buffer');
  3. console.log(buf.lastIndexOf('this').toString()); // 打印: 0
  4. console.log(buf.lastIndexOf('buffer').toString()); // 打印: 17

readBigInt64BE

readBigInt64BE(offset?: number): bigint

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

bigint

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70,
  3. 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
  4. console.log(buf.readBigInt64BE(0).toString());
  5. let buf1 = buffer.allocUninitializedFromPool(8);
  6. buf1.writeBigInt64BE(BigInt(0x0102030405060708), 0);

readBigInt64LE

readBigInt64LE(offset?: number): bigint

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

bigint

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70,
  3. 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
  4. console.log(buf.readBigInt64LE(0).toString());
  5. let buf1 = buffer.allocUninitializedFromPool(8);
  6. buf1.writeBigInt64BE(BigInt(0x0102030405060708), 0);

readBigUInt64BE

readBigUInt64BE(offset?: number): bigint

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

bigint

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70,
  3. 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
  4. console.log(buf.readBigUInt64BE(0).toString());
  5. let buf1 = buffer.allocUninitializedFromPool(8);
  6. buf1.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0);

readBigUInt64LE

readBigUInt64LE(offset?: number): bigint

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

bigint

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70,
  3. 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
  4. console.log(buf.readBigUInt64LE(0).toString());
  5. let buf1 = buffer.allocUninitializedFromPool(8);
  6. buf1.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0);

readDoubleBE

readDoubleBE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
  3. console.log(buf.readDoubleBE(0).toString());
  4. let buf1 = buffer.allocUninitializedFromPool(8);
  5. buf1.writeDoubleBE(123.456, 0);

readDoubleLE

readDoubleLE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
  3. console.log(buf.readDoubleLE(0).toString());
  4. let buf1 = buffer.allocUninitializedFromPool(8);
  5. buf1.writeDoubleLE(123.456, 0);

readFloatBE

readFloatBE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
  3. console.log(buf.readFloatBE(0).toString());
  4. let buf1 = buffer.allocUninitializedFromPool(4);
  5. buf1.writeFloatBE(0xcabcbcbc, 0);

readFloatLE

readFloatLE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
  3. console.log(buf.readFloatLE(0).toString());
  4. let buf1 = buffer.allocUninitializedFromPool(4);
  5. buf1.writeFloatLE(0xcabcbcbc, 0);

readInt8

readInt8(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([-1, 5]);
  3. console.log(buf.readInt8(0).toString()); // 打印: 0
  4. console.log(buf.readInt8(1).toString()); // 打印: 5
  5. let buf1 = buffer.allocUninitializedFromPool(2);
  6. buf1.writeInt8(0x12);

readInt16BE

readInt16BE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0, 5]);
  3. console.log(buf.readInt16BE(0).toString()); // 打印: 5
  4. let buf1 = buffer.alloc(2);
  5. buf1.writeInt16BE(0x1234, 0);

readInt16LE

readInt16LE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0, 5]);
  3. console.log(buf.readInt16LE(0).toString()); // 打印: 1280
  4. let buf1 = buffer.alloc(2);
  5. buf1.writeInt16BE(0x1234, 0);

readInt32BE

readInt32BE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0, 0, 0, 5]);
  3. console.log(buf.readInt32BE(0).toString()); // 打印: 5
  4. let buf1 = buffer.alloc(4);
  5. buf1.writeInt32BE(0x12345678, 0);

readInt32LE

readInt32LE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0, 0, 0, 5]);
  3. console.log(buf.readInt32LE(0).toString()); // 打印: 83886080
  4. let buf1 = buffer.alloc(4);
  5. buf1.writeInt32BE(0x12345678, 0);

readIntBE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

byteLength

number

读取的字节数。

返回值:

类型

说明

number

读取的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "[offset/byteLength]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from("ab");
  3. let num = buf.readIntBE(0, 1);
  4. console.log(num.toString()); // 97
  5. let buf1 = buffer.allocUninitializedFromPool(6);
  6. buf1.writeIntBE(0x123456789011, 0, 6);

readIntLE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

byteLength

number

读取的字节数。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "[offset/byteLength]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
  3. console.log(buf.readIntLE(0, 6).toString(16));
  4. let buf1 = buffer.allocUninitializedFromPool(6);
  5. buf1.writeIntLE(0x123456789011, 0, 6);

readUInt8

readUInt8(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([1, -2]);
  3. console.log(buf.readUInt8(0).toString());
  4. console.log(buf.readUInt8(1).toString());
  5. let buf1 = buffer.allocUninitializedFromPool(4);
  6. buf1.writeUInt8(0x42);

readUInt16BE

readUInt16BE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x12, 0x34, 0x56]);
  3. console.log(buf.readUInt16BE(0).toString(16));
  4. console.log(buf.readUInt16BE(1).toString(16));
  5. let buf1 = buffer.allocUninitializedFromPool(4);
  6. buf1.writeUInt16BE(0x1234, 0);

readUInt16LE

readUInt16LE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x12, 0x34, 0x56]);
  3. console.log(buf.readUInt16LE(0).toString(16));
  4. console.log(buf.readUInt16LE(1).toString(16));
  5. let buf1 = buffer.allocUninitializedFromPool(4);
  6. buf1.writeUInt16LE(0x1234, 0);

readUInt32BE

readUInt32BE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x12, 0x34, 0x56, 0x78]);
  3. console.log(buf.readUInt32BE(0).toString(16));
  4. let buf1 = buffer.allocUninitializedFromPool(4);
  5. buf1.writeUInt32BE(0x12345678, 0);

readUInt32LE

readUInt32LE(offset?: number): number

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "offset" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x12, 0x34, 0x56, 0x78]);
  3. console.log(buf.readUInt32LE(0).toString(16));
  4. let buf1 = buffer.allocUninitializedFromPool(4);
  5. buf1.writeUInt32LE(0x12345678, 0);

readUIntBE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

byteLength

number

要读取的字节数。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "[offset/byteLength]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
  3. console.log(buf.readUIntBE(0, 6).toString(16));
  4. let buf1 = buffer.allocUninitializedFromPool(4);
  5. buf1.writeUIntBE(0x13141516, 0, 4);

readUIntLE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

offset

number

偏移量。 默认值: 0。

byteLength

number

要读取的字节数。

返回值:

类型

说明

number

读取出的内容。

错误码:

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

错误码ID

错误信息

10200001

The value of "[offset/byteLength]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
  3. console.log(buf.readUIntLE(0, 6).toString(16));
  4. let buf1 = buffer.allocUninitializedFromPool(4);
  5. buf1.writeUIntLE(0x13141516, 0, 4);

subarray

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

start

number

截取开始位置。 默认值: 0。

end

number

截取结束位置(不包含结束位置)。 默认值: 当前对象的字节长度。

返回值:

类型

说明

Buffer

返回新的Buffer对象。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.allocUninitializedFromPool(26);
  3. for (let i = 0; i < 26; i++) {
  4. buf1[i] = i + 97;
  5. }
  6. const buf2 = buf1.subarray(0, 3);
  7. console.log(buf2.toString('ascii', 0, buf2.length));
  8. // 打印: abc

swap16

swap16(): Buffer

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

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

Buffer

交换之后的Buffer实例。

错误码:

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

错误码ID

错误信息

10200009

Buffer size must be a multiple of 16-bits

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
  3. console.log(buf1.toString('hex')); // 打印: 0102030405060708
  4. buf1.swap16();
  5. console.log(buf1.toString('hex')); // 打印: 0201040306050807

swap32

swap32(): Buffer

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

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

Buffer

交换之后的Buffer对象。

错误码:

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

错误码ID

错误信息

10200009

Buffer size must be a multiple of 32-bits

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
  3. console.log(buf1.toString('hex')); // 打印: 0102030405060708
  4. buf1.swap32();
  5. console.log(buf1.toString('hex')); // 打印: 0403020108070605

swap64

swap64(): Buffer

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

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

Buffer

交换之后的Buffer对象。

错误码:

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

错误码ID

错误信息

10200009

Buffer size must be a multiple of 64-bits

示例:

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

toJSON

toJSON(): Object

将Buffer转为JSON并返回。

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

Object

JSON对象。

示例:

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

toString

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

encoding

string

字符编码格式。 默认值: 'utf8'。

start

number

开始位置。 默认值: 0。

end

number

结束位置。 默认值: Buffer.length。

返回值:

类型

说明

string

字符串。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.allocUninitializedFromPool(26);
  3. for (let i = 0; i < 26; i++) {
  4. buf1[i] = i + 97;
  5. }
  6. console.log(buf1.toString('utf-8'));
  7. // 打印: abcdefghijklmnopqrstuvwxyz

values

values(): IterableIterator<number>

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

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

IterableIterator<number>

迭代器。

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf1 = buffer.from('buffer');
  3. for (let value of buf1.values()) {
  4. console.log(value.toString());
  5. }

write

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

str

string

要写入Buffer的字符串。

offset

number

偏移量。 默认值: 0。

length

number

最大字节长度。 默认值: (Buffer.length - offset)。

encoding

string

字符编码。 默认值: 'utf8'。

返回值:

类型

说明

number

返回写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[offset/length]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.alloc(256);
  3. let len = buf.write('\u00bd + \u00bc = \u00be', 0);
  4. console.log(`${len} bytes: ${buf.toString('utf-8', 0, len)}`);
  5. // 打印: 12 bytes: ½ + ¼ = ¾
  6. let buffer1 = buffer.alloc(10);
  7. let length = buffer1.write('abcd', 8);

writeBigInt64BE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

bigint

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(8);
  3. buf.writeBigInt64BE(BigInt(0x0102030405060708), 0);

writeBigInt64LE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

bigint

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(8);
  3. buf.writeBigInt64LE(BigInt(0x0102030405060708), 0);

writeBigUInt64BE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

bigint

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(8);
  3. buf.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0);

writeBigUInt64LE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

bigint

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(8);
  3. buf.writeBigUInt64LE(BigInt(0xdecafafecacefade), 0);

writeDoubleBE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(8);
  3. buf.writeDoubleBE(123.456, 0);

writeDoubleLE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(8);
  3. buf.writeDoubleLE(123.456, 0);

writeFloatBE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(8);
  3. buf.writeFloatBE(0xcafebabe, 0);

writeFloatLE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(8);
  3. buf.writeFloatLE(0xcafebabe, 0);

writeInt8

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(2);
  3. buf.writeInt8(2, 0);
  4. buf.writeInt8(-2, 1);

writeInt16BE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(2);
  3. buf.writeInt16BE(0x0102, 0);

writeInt16LE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(2);
  3. buf.writeInt16LE(0x0304, 0);

writeInt32BE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(4);
  3. buf.writeInt32BE(0x01020304, 0);

writeInt32LE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(4);
  3. buf.writeInt32LE(0x05060708, 0);

writeIntBE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

byteLength

number

要写入的字节数。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset/byteLength]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(6);
  3. buf.writeIntBE(0x1234567890ab, 0, 6);

writeIntLE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

byteLength

number

要写入的字节数。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset/byteLength]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(6);
  3. buf.writeIntLE(0x1234567890ab, 0, 6);

writeUInt8

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(4);
  3. buf.writeUInt8(0x3, 0);
  4. buf.writeUInt8(0x4, 1);
  5. buf.writeUInt8(0x23, 2);
  6. buf.writeUInt8(0x42, 3);

writeUInt16BE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(4);
  3. buf.writeUInt16BE(0xdead, 0);
  4. buf.writeUInt16BE(0xbeef, 2);

writeUInt16LE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(4);
  3. buf.writeUInt16LE(0xdead, 0);
  4. buf.writeUInt16LE(0xbeef, 2);

writeUInt32BE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(4);
  3. buf.writeUInt32BE(0xfeedface, 0);

writeUInt32LE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer对象的数字。

offset

number

偏移量。 默认值: 0。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(4);
  3. buf.writeUInt32LE(0xfeedface, 0);

writeUIntBE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

byteLength

number

要写入的字节数。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset/byteLength]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(6);
  3. buf.writeUIntBE(0x1234567890ab, 0, 6);

writeUIntLE

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

value

number

写入Buffer的数据。

offset

number

偏移量。 默认值: 0。

byteLength

number

要写入的字节数。

返回值:

类型

说明

number

写入的字节数。

错误码:

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

错误码ID

错误信息

10200001

The value of "[value/offset/byteLength]" is out of range.

示例:

  1. import buffer from '@ohos.buffer';
  2. let buf = buffer.allocUninitializedFromPool(6);
  3. buf.writeUIntLE(0x1234567890ab, 0, 6);

Blob

属性

系统能力: SystemCapability.Utils.Lang

名称

类型

可读

可写

说明

size

number

Blob实例的总字节大小。

type

string

Blob实例的内容类型。

constructor

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

Blob的构造函数。

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

sources

string[] | ArrayBuffer[] | TypedArray[] | DataView[] | Blob[]

Blob实例的数据源。

options

Object

options:

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

示例:

  1. import buffer from '@ohos.buffer';
  2. let blob = new buffer.Blob(['a', 'b', 'c']);
  3. let blob1 = new buffer.Blob(['a', 'b', 'c'], {endings:'native', type: 'MIME'});

arrayBuffer

arrayBuffer(): Promise<ArrayBuffer>

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

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

Promise<ArrayBuffer>

Promise对象,返回包含Blob数据的ArrayBuffer。

示例:

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

slice

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

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名

类型

必填

说明

start

number

起始位置。默认值为0。

end

number

结束位置。默认值为原Blob对象中的数据长度。

type

string

内容类型。默认值为''。

返回值:

类型

说明

Blob

新的Blob实例对象。

示例:

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

text

text(): Promise<string>

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

系统能力: SystemCapability.Utils.Lang

返回值:

类型

说明

Promise<string>

Promise对象,返回包含以UTF8解码的文本。

示例:

  1. let blob = new buffer.Blob(['a', 'b', 'c']);
  2. let pro = blob.text();
  3. pro.then(val => {
  4. console.log(val)
  5. });
系统帐号管理
xml转换JavaScript
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

媒体组件

像素

枚举

类型

接口

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }