# @ohos.buffer (Buffer) Buffer对象用于表示固定长度的字节序列，是专门存放二进制数据的缓存区。 推荐使用场景： 适用于处理大量二进制数据，如图片处理和文件接收上传等。 ![](https://media:101783335728984164) 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 #### 导入模块 ``` import { buffer } from '@kit.ArkTS'; ``` #### BufferEncoding type BufferEncoding = 'ascii' \| 'utf8' \| 'utf-8' \| 'utf16le' \| 'ucs2' \| 'ucs-2' \| 'base64' \| 'base64url' \| 'latin1' \| 'binary' \| 'hex' 表示支持的编码格式类型。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： 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对象并初始化。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-------|:------------------------------------|:-|:-----------------------------------| |size|number|是|指定的Buffer对象长度，单位：字节。| |fill|string \| [Buffer](#buffer) \| number|否|填充至新缓存区的值，默认值：0。| |encoding|[BufferEncoding](#bufferencoding)|否|编码格式（当fill为string时，才有意义）。默认值：'utf8'。| 返回值： |类型|说明| |:----------------|:------------| |[Buffer](#buffer)|返回一个Buffer对象。| 示例： ``` import { buffer, JSON } from '@kit.ArkTS'; let buf1 = buffer.alloc(5); console.info(JSON.stringify(buf1)); // {"type":"Buffer","data":[0,0,0,0,0]} let buf2 = buffer.alloc(5, 'a'); console.info(JSON.stringify(buf2)); // {"type":"Buffer","data":[97,97,97,97,97]} let buf3 = buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64'); console.info(JSON.stringify(buf3)); // {"type":"Buffer","data":[104,101,108,108,111,32,119,111,114,108,100]} ``` #### buffer.allocUninitializedFromPool allocUninitializedFromPool(size: number): Buffer 创建指定大小未初始化的Buffer对象。内存从缓冲池分配。 创建的Buffer内容未知，需要使用[fill](#fill)函数来初始化Buffer对象。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---|:-----|:-|:-------------------| |size|number|是|指定的Buffer对象长度，单位：字节。| 返回值： |类型|说明| |:----------------|:-------------| |[Buffer](#buffer)|未初始化的Buffer实例。| 示例： ``` import { buffer, JSON } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(10); buf.fill(0); console.info(JSON.stringify(buf)); // {"type":"Buffer","data":[0,0,0,0,0,0,0,0,0,0]} ``` #### buffer.allocUninitialized allocUninitialized(size: number): Buffer 创建指定大小未初始化的Buffer对象。内存不从缓冲池分配。 创建的Buffer的内容未知，需要使用[fill](#fill)函数来初始化Buffer对象。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---|:-----|:-|:-------------------| |size|number|是|指定的Buffer对象长度，单位：字节。| 返回值： |类型|说明| |:----------------|:-------------| |[Buffer](#buffer)|未初始化的Buffer实例。| 示例： ``` import { buffer, JSON } from '@kit.ArkTS'; let buf = buffer.allocUninitialized(10); buf.fill(0); console.info(JSON.stringify(buf)); // {"type":"Buffer","data":[0,0,0,0,0,0,0,0,0,0]} ``` #### buffer.byteLength byteLength(string: string \| Buffer \| TypedArray \| DataView \| ArrayBuffer \| SharedArrayBuffer, encoding?: BufferEncoding): number 根据不同的编码格式，返回指定字符串的字节数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-------|:----------------------------------------------------------------------------------------|:-|:---------------| |string|string \| [Buffer](#buffer) \| TypedArray \| DataView \| ArrayBuffer \| SharedArrayBuffer|是|指定字符串。| |encoding|[BufferEncoding](#bufferencoding)|否|编码格式。默认值：'utf8'。| 返回值： |类型|说明| |:-----|:-----------| |number|返回指定字符串的字节数。| 示例： ``` import { buffer } from '@kit.ArkTS'; let str = '\u00bd + \u00bc = \u00be'; console.info(`${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对象的比较结果，通常用于对Buffer对象数组进行排序。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---|:------------------------------|:-|:-----| |buf1|[Buffer](#buffer) \| Uint8Array|是|待比较数组。| |buf2|[Buffer](#buffer) \| Uint8Array|是|待比较数组。| 返回值： |类型|说明| |:-----------|:-------------------------------------------------------------------| |-1 \| 0 \| 1|如果buf1与buf2相同，则返回0。 如果排序时buf1位于buf2之后，则返回1。 如果排序时buf1位于buf2之前，则返回-1。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from('1234'); let buf2 = buffer.from('0123'); let res = buffer.compare(buf1, buf2); console.info(Number(res).toString()); // 输出结果：1 ``` #### buffer.concat concat(list: Buffer\[\] \| Uint8Array\[\], totalLength?: number): Buffer 将数组中的内容复制指定字节长度到新的Buffer对象中并返回。 系统能力： SystemCapability.Utils.Lang 元服务API：从API version 11开始，该接口支持在元服务中使用。 参数： |参数名|类型|必填|说明| |:----------|:--------------------------------------|:-|:----------------| |list|[Buffer](#buffer)\[\] \| Uint8Array\[\]|是|实例数组。| |totalLength|number|否|需要复制的总字节长度，默认值为0。| 返回值： |类型|说明| |:----------------|:------------| |[Buffer](#buffer)|返回新的Buffer对象。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:--------------------------------------------------------------------------------------------------------| |10200001|The value of "length" is out of range. It must be \>= 0 and \<= uint32 max. Received value is: \[length\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from("1234"); let buf2 = buffer.from("abcd"); let buf = buffer.concat([buf1, buf2]); console.info(buf.toString('hex')); // 输出结果：3132333461626364 ``` #### buffer.from from(array: number\[\]): Buffer 根据指定数组创建新的Buffer对象。 系统能力： SystemCapability.Utils.Lang 元服务API：从API version 11开始，该接口支持在元服务中使用。 参数： |参数名|类型|必填|说明| |:----|:---------|:-|:----| |array|number\[\]|是|指定数组。| 返回值： |类型|说明| |:----------------|:----------| |[Buffer](#buffer)|新的Buffer对象。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x62, 0x75, 0x66, 0x66, 0x65, 0x72]); console.info(buf.toString('hex')); // 输出结果：627566666572 ``` #### buffer.from from(arrayBuffer: ArrayBuffer \| SharedArrayBuffer, byteOffset?: number, length?: number): Buffer 创建与arrayBuffer共享内存的指定长度的Buffer对象。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:----------|:-------------------------------|:-|:--------------------------------------------------------------| |arrayBuffer|ArrayBuffer \| SharedArrayBuffer|是|实例对象。| |byteOffset|number|否|字节偏移量，默认值：0。| |length|number|否|字节长度， 默认值:（arrayBuffer.byteLength - byteOffset）。在传入null时字节长度为0。| 返回值： |类型|说明| |:----------------|:-----------------------------------------| |[Buffer](#buffer)|返回一个Buffer对象，该对象与入参对象arrayBuffer共享相同的内存区域。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[byteOffset/length\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[byteOffset/length\]| 示例： ``` import { buffer, JSON } from '@kit.ArkTS'; let ab = new ArrayBuffer(10); let buf = buffer.from(ab, 0, 2); console.info(JSON.stringify(buf)); // {"type":"Buffer","data":[0,0]} ``` #### buffer.from from(buffer: Buffer \| Uint8Array): Buffer 当入参为Buffer对象时，创建新的Buffer对象并复制入参Buffer对象的数据，然后返回新对象。 当入参为Uint8Array对象时，基于Uint8Array对象的内存创建新的Buffer对象并返回，保持数据的内存关联。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:------------------------------|:-|:----| |buffer|[Buffer](#buffer) \| Uint8Array|是|对象数据。| 返回值： |类型|说明| |:----------------|:----------| |[Buffer](#buffer)|新的Buffer对象。| 示例： ``` import { buffer } from '@kit.ArkTS'; // 以Buffer对象类型进行创建新的Buffer对象 let buf1 = buffer.from('buffer'); let buf2 = buffer.from(buf1); // 以Uint8Array对象类型进行创建Buffer对象，保持对象间内存共享 let uint8Array = new Uint8Array(10); let buf3 = buffer.from(uint8Array); buf3.fill(1); console.info("uint8Array:", uint8Array); // 输出结果：1,1,1,1,1,1,1,1,1,1 ``` #### buffer.from from(object: Object, offsetOrEncoding: number \| string, length: number): Buffer 根据指定的object类型数据，创建新的Buffer对象。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------------|:---------------|:-|:--------------------------------------------------------------------------------------------------------------------------------------------| |object|Object|是|支持Symbol.toPrimitive或valueOf()的对象。| |offsetOrEncoding|number \| string|是|字节偏移量或编码格式。| |length|number|是|字节长度（此入参仅在object的valueOf()返回值为ArrayBuffer时生效，取值范围：0 \<= length \<= ArrayBuffer.byteLength，超出范围时报错: 10200001）。其他情况下可填任意number类型值，该参数不会对结果产生影响。| 返回值： |类型|说明| |:----------------|:------------| |[Buffer](#buffer)|返回新的Buffer对象。| 示例： ``` import { buffer, JSON } from '@kit.ArkTS'; let buf = buffer.from(new String('this is a test'), 'utf8', 14); console.info(JSON.stringify(buf)); // {"type":"Buffer","data":[116,104,105,115,32,105,115,32,97,32,116,101,115,116]} ``` #### buffer.from from(string: String, encoding?: BufferEncoding): Buffer 根据指定编码格式的字符串，创建新的Buffer对象。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-------|:--------------------------------|:-|:---------------| |string|String|是|字符串。| |encoding|[BufferEncoding](#bufferencoding)|否|编码格式。默认值：'utf8'。| 返回值： |类型|说明| |:----------------|:------------| |[Buffer](#buffer)|返回新的Buffer对象。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from('this is a test'); let buf2 = buffer.from('7468697320697320612074c3a97374', 'hex'); console.info(buf1.toString()); // 输出结果：this is a test console.info(buf2.toString()); // 输出结果：this is a tést ``` #### buffer.isBuffer isBuffer(obj: Object): boolean 判断obj是否为Buffer。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:--|:-----|:-|:----| |obj|Object|是|判断对象。| 返回值： |类型|说明| |:------|:------------------------------| |boolean|如果obj是Buffer，则返回true，否则返回false。| 示例： ``` import { buffer } from '@kit.ArkTS'; let result = buffer.isBuffer(buffer.alloc(10)); // 10: buffer size console.info("result = " + result); // 输出结果：result = true let result1 = buffer.isBuffer(buffer.from('foo')); console.info("result1 = " + result1); // 输出结果：result1 = true let result2 = buffer.isBuffer('a string'); console.info("result2 = " + result2); // 输出结果：result2 = false let result3 = buffer.isBuffer([]); console.info("result3 = " + result3); // 输出结果：result3 = false let result4 = buffer.isBuffer(new Uint8Array(1024)); console.info("result4 = " + result4); // 输出结果：result4 = false ``` #### buffer.isEncoding isEncoding(encoding: string): boolean 判断encoding是否为支持的编码格式。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-------|:-----|:-|:----| |encoding|string|是|编码格式。| 返回值： |类型|说明| |:------|:-------------------------| |boolean|是支持的编码格式返回true，反之则返回false。| 示例： ``` import { buffer } from '@kit.ArkTS'; console.info(buffer.isEncoding('utf-8').toString()); // 输出结果：true console.info(buffer.isEncoding('hex').toString()); // 输出结果：true console.info(buffer.isEncoding('utf/8').toString()); // 输出结果：false console.info(buffer.isEncoding('').toString()); // 输出结果：false ``` #### buffer.transcode transcode(source: Buffer \| Uint8Array, fromEnc: string, toEnc: string): Buffer 将Buffer或Uint8Array对象从一种字符编码重新编码为另一种。 系统能力： SystemCapability.Utils.Lang 元服务API：从API version 11开始，该接口支持在元服务中使用。 参数： |参数名|类型|必填|说明| |:------|:------------------------------|:-|:-----------------------------------------------| |source|[Buffer](#buffer) \| Uint8Array|是|实例对象。| |fromEnc|string|是|当前编码。 支持的格式范围为[BufferEncoding](#bufferencoding)。| |toEnc|string|是|目标编码。 支持的格式范围为[BufferEncoding](#bufferencoding)。| 返回值： |类型|说明| |:----------------|:----------------------------| |[Buffer](#buffer)|将当前编码转换成目标编码，并返回一个新的Buffer对象。| 示例： ``` import { buffer } from '@kit.ArkTS'; let newBuf = buffer.transcode(buffer.from('€'), 'utf-8', 'ascii'); console.info("newBuf = " + newBuf.toString('ascii')); // 输出结果：newBuf = , ``` #### Buffer #### 属性 系统能力： SystemCapability.Utils.Lang 元服务API：从API version 11开始，该接口支持在元服务中使用。 |名称|类型|只读|可选|说明| |:---------|:----------|:-|:-|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |length|number|是|否|Buffer对象的字节长度。| |buffer|ArrayBuffer|是|否|ArrayBuffer对象。| |byteOffset|number|是|否|当前Buffer所在内存池的偏移量。 - 当Buffer通过内存池创建时（如使用[allocUninitializedFromPool](#bufferallocuninitializedfrompool)创建Buffer，或使用buffer.from()传入字符串，且字符串长度加当前内存池偏移量小于4kb），返回相对于内存池的偏移量。 - 当Buffer直接分配内存时（如使用[alloc](#bufferalloc)），返回值为0。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------| |10200013|${propertyName} cannot be set for the buffer that has only a getter.| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from("12345678"); console.info(JSON.stringify(buf.length)); // 输出结果：8 let arrayBuffer = buf.buffer; console.info(JSON.stringify(new Uint8Array(arrayBuffer))); // 输出结果：{"0":49,"1":50,"2":51,"3":52,"4":53,"5":54,"6":55,"7":56} console.info(JSON.stringify(buf.byteOffset)); // 输出结果：0 let buf1 = buffer.from("abcd"); console.info(JSON.stringify(buf1.byteOffset)); // 输出结果：8 ``` #### compare compare(target: Buffer \| Uint8Array, targetStart?: number, targetEnd?: number, sourceStart?: number, sourceEnd?: number): -1 \| 0 \| 1 比较当前Buffer对象与目标Buffer对象，并返回Buffer在排序中的结果。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:----------|:------------------------------|:-|:--------------------------------------| |target|[Buffer](#buffer) \| Uint8Array|是|要比较的实例对象。| |targetStart|number|否|target实例中开始的偏移量。默认值：0。| |targetEnd|number|否|target实例中结束的偏移量（不包含结束位置）。默认值：目标对象的字节长度。| |sourceStart|number|否|this实例中开始的偏移量。默认值：0。| |sourceEnd|number|否|this实例中结束的偏移量（不包含结束位置）。默认值：当前对象的字节长度。| 返回值： |类型|说明| |:-----|:---------------------------------------| |number|返回比较结果。-1：当前排列在目标前，0：当前与目标相同，1：当前排列在目标后。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[targetStart/targetEnd/sourceStart/sourceEnd\]" is out of range. It must be \>= 0 and \<= \[right range\]. Received value is: \[targetStart/targetEnd/sourceStart/sourceEnd\]| 示例： ``` import { buffer } from '@kit.ArkTS'; 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.info(buf1.compare(buf2, 5, 9, 0, 4).toString()); // 输出结果：0 console.info(buf1.compare(buf2, 0, 6, 4).toString()); // 输出结果：-1 console.info(buf1.compare(buf2, 5, 6, 5).toString()); // 输出结果：1 ``` #### copy copy(target: Buffer\| Uint8Array, targetStart?: number, sourceStart?: number, sourceEnd?: number): number 将this实例中指定位置的数据复制到target的指定位置上，并返回复制的字节总长度。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:----------|:------------------------------|:-|:--------------------------------------| |target|[Buffer](#buffer) \| Uint8Array|是|要复制到的Buffer或Uint8Array实例。| |targetStart|number|否|target实例中开始写入的偏移量。默认值：0。| |sourceStart|number|否|this实例中开始复制的偏移量。默认值: 0。| |sourceEnd|number|否|this实例中结束复制的偏移量（不包含结束位置）。默认值：当前对象的字节长度。| 返回值： |类型|说明| |:-----|:--------| |number|复制的字节总长度。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-----------------------------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[targetStart/sourceStart/sourceEnd\]" is out of range. It must be \>= 0. Received value is: \[targetStart/sourceStart/sourceEnd\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.allocUninitializedFromPool(26); let buf2 = buffer.allocUninitializedFromPool(26).fill('!'); for (let i = 0; i < 26; i++) { buf1.writeInt8(i + 97, i); } buf1.copy(buf2, 8, 16, 20); console.info(buf2.toString('ascii', 0, 25)); // 输出结果：!!!!!!!!qrst!!!!!!!!!!!!! ``` #### entries entries(): IterableIterator\<\[number, number\]\> 返回一个包含key和value的迭代器。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:-------------------------------------|:------------------------------| |IterableIterator\<\[number, number\]\>|包含key和value的迭代器，同时两者皆为number类型。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from('buffer'); let pair = buf.entries(); let next: IteratorResult = pair.next(); while (!next.done) { console.info("buffer: " + next.value); /* 输出结果：buffer: 0,98 buffer: 1,117 buffer: 2,102 buffer: 3,102 buffer: 4,101 buffer: 5,114 */ next = pair.next(); } ``` #### equals equals(otherBuffer: Uint8Array \| Buffer): boolean 比较this实例和otherBuffer实例是否相等。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:----------|:------------------------------|:-|:-------| |otherBuffer|Uint8Array \| [Buffer](#buffer)|是|比较的目标对象。| 返回值： |类型|说明| |:------|:-------------------| |boolean|相等则返回true，否则返回false。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from('ABC'); let buf2 = buffer.from('414243', 'hex'); let buf3 = buffer.from('ABCD'); console.info(buf1.equals(buf2).toString()); // 输出结果：true console.info(buf1.equals(buf3).toString()); // 输出结果：false ``` #### fill fill(value: string \| Buffer \| Uint8Array \| number, offset?: number, end?: number, encoding?: BufferEncoding): Buffer 使用value填充当前对象指定位置的数据，默认为循环填充，并返回填充后的Buffer对象。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-------|:--------------------------------------------------|:-|:-----------------------------------| |value|string \| [Buffer](#buffer) \| Uint8Array \| number|是|用于填充的值。| |offset|number|否|起始偏移量。默认值：0。| |end|number|否|结束偏移量（不包含结束位置）。 默认值：当前对象的字节长度。| |encoding|[BufferEncoding](#bufferencoding)|否|字符编码格式（value为string才有意义）。默认值：'utf8'。| 返回值： |类型|说明| |:----------------|:--------------| |[Buffer](#buffer)|返回填充后的Buffer对象。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[offset/end\]" is out of range. It must be \>= 0 and \<= \[right range\]. Received value is: \[offset/end\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let b = buffer.allocUninitializedFromPool(50).fill('h'); console.info(b.toString()); // 输出结果：hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh ``` #### includes includes(value: string \| number \| Buffer \| Uint8Array, byteOffset?: number, encoding?: BufferEncoding): boolean 检查Buffer对象是否包含value值。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:--------------------------------------------------|:-|:-----------------------------| |value|string \| number \| [Buffer](#buffer) \| Uint8Array|是|要搜索的内容。| |byteOffset|number|否|字节偏移量。如果为负数，则从末尾开始计算偏移量。默认值：0。| |encoding|[BufferEncoding](#bufferencoding)|否|字符编码格式。默认值：'utf8'。| 返回值： |类型|说明| |:------|:----------------| |boolean|存在为true，否则为false。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from('this is a buffer'); console.info(buf.includes('this').toString()); // 输出结果：true console.info(buf.includes('be').toString()); // 输出结果：false ``` #### indexOf indexOf(value: string \| number \| Buffer \| Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number 返回当前对象中首次出现value的索引，如果不包含value，则返回-1。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:--------------------------------------------------|:-|:-----------------------------| |value|string \| number \| [Buffer](#buffer) \| Uint8Array|是|要查找的内容。| |byteOffset|number|否|字节偏移量。如果为负数，则从末尾开始计算偏移量。默认值：0。| |encoding|[BufferEncoding](#bufferencoding)|否|字符编码格式。默认值：'utf8'。| 返回值： |类型|说明| |:-----|:-------| |number|第一次出现位置。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from('this is a buffer'); console.info(buf.indexOf('this').toString()); // 输出结果：0 console.info(buf.indexOf('is').toString()); // 输出结果：2 ``` #### keys keys(): IterableIterator\ 返回包含key值的迭代器。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:-------------------------|:--------------| |IterableIterator\|返回一个包含key值的迭代器。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from('buffer'); let keys = buf.keys(); for (const key of keys) { console.info(key.toString()); } /* 输出结果：0 1 2 3 4 5 */ ``` #### lastIndexOf lastIndexOf(value: string \| number \| Buffer \| Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number 返回this实例中最后一次出现value的索引，如果对象不包含value，则返回-1。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:--------------------------------------------------|:-|:-----------------------------------------| |value|string \| number \| [Buffer](#buffer) \| Uint8Array|是|要搜索的内容。| |byteOffset|number|否|字节偏移量。如果为负数，则从末尾开始计算偏移量。默认值：Buffer.length。| |encoding|[BufferEncoding](#bufferencoding)|否|字符编码格式。默认值：'utf8'。| 返回值： |类型|说明| |:-----|:---------------| |number|最后一次出现value值的索引。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from('this buffer is a buffer'); console.info(buf.lastIndexOf('this').toString()); // 输出结果：0 console.info(buf.lastIndexOf('buffer').toString()); // 输出结果：17 ``` #### readBigInt64BE readBigInt64BE(offset?: number): bigint 从指定的offset处读取有符号的大端序64位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 8。| 返回值： |类型|说明| |:-----|:------| |bigint|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 8. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]); console.info(buf.readBigInt64BE(0).toString()); // 输出结果：7161960797921896816 let buf1 = buffer.allocUninitializedFromPool(8); let result = buf1.writeBigInt64BE(BigInt(0x0102030405060708), 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### readBigInt64LE readBigInt64LE(offset?: number): bigint 从指定的offset处读取有符号的小端序64位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 8，默认值：0。| 返回值： |类型|说明| |:-----|:------| |bigint|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 8. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]); console.info(buf.readBigUInt64LE(0).toString()); // 输出结果：8100120198111388771 let buf1 = buffer.allocUninitializedFromPool(8); let result = buf1.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### readBigUInt64BE readBigUInt64BE(offset?: number): bigint 从指定的offset处读取无符号的大端序64位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 8，默认值：0。| 返回值： |类型|说明| |:-----|:------| |bigint|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 8. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]); console.info(buf.readBigUInt64BE(0).toString()); // 输出结果：7161960797921896816 let buf1 = buffer.allocUninitializedFromPool(8); let result = buf1.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### readBigUInt64LE readBigUInt64LE(offset?: number): bigint 从指定的offset处读取无符号的小端序64位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 8，默认值：0。| 返回值： |类型|说明| |:-----|:------| |bigint|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 8. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]); console.info(buf.readBigUInt64LE(0).toString()); // 输出结果：8100120198111388771 let buf1 = buffer.allocUninitializedFromPool(8); let result = buf1.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### readDoubleBE readDoubleBE(offset?: number): number 从指定的offset处读取64位大端序双精度值。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 8，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 8. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]); console.info(buf.readDoubleBE(0).toString()); // 输出结果：8.20788039913184e-304 let buf1 = buffer.allocUninitializedFromPool(8); let result = buf1.writeDoubleBE(123.456, 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### readDoubleLE readDoubleLE(offset?: number): number 从指定的offset处读取64位小端序双精度值。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 8，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 8. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]); console.info(buf.readDoubleLE(0).toString()); // 输出结果：5.447603722011605e-270 let buf1 = buffer.allocUninitializedFromPool(8); let result = buf1.writeDoubleLE(123.456, 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### readFloatBE readFloatBE(offset?: number): number 从指定的offset处读取32位大端序浮点数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 4，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 4. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]); console.info(buf.readFloatBE(0).toString()); // 输出结果：2.387939260590663e-38 let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeFloatBE(0xcabcbcbc, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### readFloatLE readFloatLE(offset?: number): number 从指定的offset处读取32位小端序浮点数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 4，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 4. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]); console.info(buf.readFloatLE(0).toString()); // 输出结果：1.539989614439558e-36 let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeFloatLE(0xcabcbcbc, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### readInt8 readInt8(offset?: number): number 从指定的offset处读取有符号的8位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 1，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 1. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([-1, 5]); console.info(buf.readInt8(0).toString()); // 输出结果：0 console.info(buf.readInt8(1).toString()); // 输出结果：5 let buf1 = buffer.allocUninitializedFromPool(2); let result = buf1.writeInt8(0x12); console.info("result = " + result); // 输出结果：result = 1 ``` #### readInt16BE readInt16BE(offset?: number): number 从指定的offset处读取有符号的大端序16位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 2，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 2. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0, 5]); console.info(buf.readInt16BE(0).toString()); // 输出结果：5 let buf1 = buffer.alloc(2); let result = buf1.writeInt16BE(0x1234, 0); console.info("result = " + result); // 输出结果：result = 2 ``` #### readInt16LE readInt16LE(offset?: number): number 从指定的offset处读取有符号的小端序16位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 2，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 2. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0, 5]); console.info(buf.readInt16LE(0).toString()); // 输出结果：1280 let buf1 = buffer.alloc(2); let result = buf1.writeInt16BE(0x1234, 0); console.info("result = " + result); // 输出结果：result = 2 ``` #### readInt32BE readInt32BE(offset?: number): number 从指定的offset处读取有符号的大端序32位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 4，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 4. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0, 0, 0, 5]); console.info(buf.readInt32BE(0).toString()); // 输出结果：5 let buf1 = buffer.alloc(4); let result = buf1.writeInt32BE(0x12345678, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### readInt32LE readInt32LE(offset?: number): number 从指定的offset处读取有符号的小端序32位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 4，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 4. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0, 0, 0, 5]); console.info(buf.readInt32LE(0).toString()); // 输出结果：83886080 let buf1 = buffer.alloc(4); let result = buf1.writeInt32BE(0x12345678, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### readIntBE readIntBE(offset: number, byteLength: number): number 从指定的offset处读取byteLength个字节，并将结果解释为支持最高48位精度的大端序、二进制补码有符号值。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:-----|:-|:----------------------------------------------------------| |offset|number|是|偏移量。取值范围：0 \<= offset \<= Buffer.length - byteLength，默认值：0。| |byteLength|number|是|读取的字节数。取值范围：1 \<= byteLength \<= 6。| 返回值： |类型|说明| |:-----|:-----------------------------| |number|读取的内容。当offset为小数时，返回undefined。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from("ab"); let num = buf.readIntBE(0, 1); console.info(num.toString()); // 输出结果：97 let buf1 = buffer.allocUninitializedFromPool(6); let result = buf1.writeIntBE(0x123456789011, 0, 6); console.info("result = " + result); // 输出结果：result = 6 ``` #### readIntLE readIntLE(offset: number, byteLength: number): number 从指定的offset处读取byteLength个字节，并将结果解释为支持最高48位精度的小端序、二进制补码有符号值。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:-----|:-|:----------------------------------------------------------| |offset|number|是|偏移量。取值范围：0 \<= offset \<= Buffer.length - byteLength，默认值：0。| |byteLength|number|是|读取的字节数。取值范围：1 \<= byteLength \<= 6。| 返回值： |类型|说明| |:-----|:------------------------------| |number|读取出的内容。当offset为小数时，返回undefined。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]); console.info(buf.readIntLE(0, 6).toString(16)); // 输出结果：-546f87a9cbee let buf1 = buffer.allocUninitializedFromPool(6); let result = buf1.writeIntLE(0x123456789011, 0, 6); console.info("result = " + result); // 输出结果：result = 6 ``` #### readUInt8 readUInt8(offset?: number): number 从offset处读取8位无符号整型数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 1，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 1. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([1, -2]); console.info(buf.readUInt8(0).toString()); // 输出结果：1 console.info(buf.readUInt8(1).toString()); // 输出结果：0 let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeUInt8(0x42); console.info("result = " + result); // 输出结果：result = 1 ``` #### readUInt16BE readUInt16BE(offset?: number): number 从指定的offset处读取无符号的大端序16位整数。 系统能力： SystemCapability.Utils.Lang 元服务API：从API version 11开始，该接口支持在元服务中使用。 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 2，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 2. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x12, 0x34, 0x56]); console.info(buf.readUInt16BE(0).toString(16)); // 输出结果：1234 console.info(buf.readUInt16BE(1).toString(16)); // 输出结果：3456 let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeUInt16BE(0x1234, 0); console.info("result = " + result); // 输出结果：result = 2 ``` #### readUInt16LE readUInt16LE(offset?: number): number 从指定的offset处的buf读取无符号的小端序16位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 2，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 2. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x12, 0x34, 0x56]); console.info(buf.readUInt16LE(0).toString(16)); // 输出结果：3412 console.info(buf.readUInt16LE(1).toString(16)); // 输出结果：5634 let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeUInt16LE(0x1234, 0); console.info("result = " + result); // 输出结果：result = 2 ``` #### readUInt32BE readUInt32BE(offset?: number): number 从指定的offset处的buf读取无符号的大端序32位整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 4，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 4. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x12, 0x34, 0x56, 0x78]); console.info(buf.readUInt32BE(0).toString(16)); // 输出结果：12345678 let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeUInt32BE(0x12345678, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### readUInt32LE readUInt32LE(offset?: number): number 从指定的offset处的buf读取无符号的小端序32位整数。 系统能力： SystemCapability.Utils.Lang 元服务API：从API version 11开始，该接口支持在元服务中使用。 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |offset|number|否|偏移量。取值范围：0 \<= offset \<= Buffer.length - 4，默认值：0。| 返回值： |类型|说明| |:-----|:------| |number|读取出的内容。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:-------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 4. Received value is: \[offset\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x12, 0x34, 0x56, 0x78]); console.info(buf.readUInt32LE(0).toString(16)); // 输出结果：78563412 let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeUInt32LE(0x12345678, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### readUIntBE readUIntBE(offset: number, byteLength: number): number 从指定的offset处的buf读取byteLength个字节，并将结果解释为支持最高48位精度的无符号大端序整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:-----|:-|:----------------------------------------------------------| |offset|number|是|偏移量。取值范围：0 \<= offset \<= Buffer.length - byteLength，默认值：0。| |byteLength|number|是|要读取的字节数。读取的字节数。取值范围：1 \<= byteLength \<= 6。| 返回值： |类型|说明| |:-----|:------------------------------| |number|读取出的内容。当offset为小数时，返回undefined。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]); console.info(buf.readUIntBE(0, 6).toString(16)); // 输出结果：1234567890ab let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeUIntBE(0x13141516, 0, 4); console.info("result = " + result); // 输出结果：result = 4 ``` #### readUIntLE readUIntLE(offset: number, byteLength: number): number 从指定的offset处的buf读取byteLength个字节，并将结果解释为支持最高48位精度的无符号小端序整数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:-----|:-|:----------------------------------------------------------| |offset|number|是|偏移量。取值范围：0 \<= offset \<= Buffer.length - byteLength，默认值：0。| |byteLength|number|是|读取的字节数。取值范围：1 \<= byteLength \<= 6。| 返回值： |类型|说明| |:-----|:------------------------------| |number|读取出的内容。当offset为小数时，返回undefined。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]); console.info(buf.readUIntLE(0, 6).toString(16)); // 输出结果：ab9078563412 let buf1 = buffer.allocUninitializedFromPool(4); let result = buf1.writeUIntLE(0x13141516, 0, 4); console.info("result = " + result); // 输出结果：result = 4 ``` #### subarray subarray(start?: number, end?: number): Buffer 截取当前对象指定位置的数据并返回。 系统能力： SystemCapability.Utils.Lang 元服务API：从API version 11开始，该接口支持在元服务中使用。 参数： |参数名|类型|必填|说明| |:----|:-----|:-|:-----------------------------------------------| |start|number|否|截取开始位置。默认值：0。| |end|number|否|截取结束位置（不包含结束位置）。默认值：当前对象的字节长度。在传入null时返回空Buffer。| 返回值： |类型|说明| |:----------------|:-------------------------------------------| |[Buffer](#buffer)|返回新的Buffer对象。当start \< 0或end \< 0时返回空Buffer。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.allocUninitializedFromPool(26); for (let i = 0; i < 26; i++) { buf1.writeInt8(i + 97, i); } const buf2 = buf1.subarray(0, 3); console.info(buf2.toString('ascii', 0, buf2.length)); // 输出结果: abc ``` #### swap16 swap16(): Buffer 将当前对象转换为无符号的16位整数数组，并交换字节顺序。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:----------------|:-------------| |[Buffer](#buffer)|交换之后的Buffer对象。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:---------------------------------------------| |10200009|The buffer size must be a multiple of 16-bits.| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]); console.info(buf1.toString('hex')); // 输出结果：0102030405060708 buf1.swap16(); console.info(buf1.toString('hex')); // 输出结果：0201040306050807 ``` #### swap32 swap32(): Buffer 将当前对象转换为无符号的32位整数数组，并交换字节顺序。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:----------------|:-------------| |[Buffer](#buffer)|交换之后的Buffer对象。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:---------------------------------------------| |10200009|The buffer size must be a multiple of 32-bits.| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]); console.info(buf1.toString('hex')); // 输出结果：0102030405060708 buf1.swap32(); console.info(buf1.toString('hex')); // 输出结果：0403020108070605 ``` #### swap64 swap64(): Buffer 将当前对象转换为无符号的64位整数数组，并交换字节顺序。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:----------------|:-------------| |[Buffer](#buffer)|交换之后的Buffer对象。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:---------------------------------------------| |10200009|The buffer size must be a multiple of 64-bits.| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]); console.info(buf1.toString('hex')); // 输出结果：0102030405060708 buf1.swap64(); console.info(buf1.toString('hex')); // 输出结果：0807060504030201 ``` #### toJSON toJSON(): Object 将Buffer转为JSON并返回。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:-----|:------| |Object|JSON对象。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5]); let obj = buf1.toJSON(); console.info(JSON.stringify(obj)); // 输出结果: {"type":"Buffer","data":[1,2,3,4,5]} ``` #### toString toString(encoding?: string, start?: number, end?: number): string 将当前对象中指定位置的数据转成指定编码格式的字符串并返回。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-------|:-----|:-|:----------------------| |encoding|string|否|字符编码格式。默认值：'utf8'。| |start|number|否|开始位置。默认值：0。| |end|number|否|结束位置。默认值：Buffer.length。| 返回值： |类型|说明| |:-----|:------------------------------------------------| |string|字符串。当start \>= Buffer.length或start \> end时返回空字符串。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.allocUninitializedFromPool(26); for (let i = 0; i < 26; i++) { buf1.writeInt8(i + 97, i); } console.info(buf1.toString('utf-8')); // 输出结果: abcdefghijklmnopqrstuvwxyz ``` #### values values(): IterableIterator\ 返回一个包含value的迭代器。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:-------------------------|:---| |IterableIterator\|迭代器。| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf1 = buffer.from('buffer'); let pair = buf1.values(); let next:IteratorResult = pair.next(); while (!next.done) { console.info(next.value.toString()); /* 输出结果：98 117 102 102 101 114 */ next = pair.next(); } ``` #### write write(str: string, offset?: number, length?: number, encoding?: string): number 在Buffer对象的offset偏移处写入指定编码的字符串，写入的字节长度为length。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-------|:-----|:-|:-----------------------------------| |str|string|是|要写入Buffer的字符串。| |offset|number|否|偏移量。默认值：0。| |length|number|否|最大字节长度。默认值：(Buffer.length - offset)。| |encoding|string|否|字符编码。默认值：'utf8'。| 返回值： |类型|说明| |:-----|:------| |number|写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:---------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[offset/length\]" is out of range. It must be \>= 0 and \<= buf.length. Received value is: \[offset/length\].| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.alloc(256); let len = buf.write('\u00bd + \u00bc = \u00be', 0); console.info(`${len} bytes: ${buf.toString('utf-8', 0, len)}`); // 输出结果: 12 bytes: ½ + ¼ = ¾ let buffer1 = buffer.alloc(10); let length = buffer1.write('abcd', 8); console.info("length = " + length); // 输出结果：length = 2 ``` #### writeBigInt64BE writeBigInt64BE(value: bigint, offset?: number): number 在Buffer对象的offset偏移处写入有符号的大端序64位BigInt型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|bigint|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 8。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(8); let result = buf.writeBigInt64BE(BigInt(0x0102030405060708), 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### writeBigInt64LE writeBigInt64LE(value: bigint, offset?: number): number 在Buffer对象的offset偏移处写入有符号的小端序64位BigInt型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|bigint|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 8。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(8); let result = buf.writeBigInt64LE(BigInt(0x0102030405060708), 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### writeBigUInt64BE writeBigUInt64BE(value: bigint, offset?: number): number 元服务API：从API version 11开始，该接口支持在元服务中使用。 在Buffer对象的offset偏移处写入无符号的大端序64位BigUInt型数据。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|bigint|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 8。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(8); let result = buf.writeBigUInt64BE(BigInt(0xdecafafecacefade), 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### writeBigUInt64LE writeBigUInt64LE(value: bigint, offset?: number): number 在Buffer对象的offset偏移处写入无符号的小端序64位BigUInt型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|bigint|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 8。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(8); let result = buf.writeBigUInt64LE(BigInt(0xdecafafecacefade), 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### writeDoubleBE writeDoubleBE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入大端序的64位双浮点型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 8。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 8. Received value is: \[offset\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(8); let result = buf.writeDoubleBE(123.456, 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### writeDoubleLE writeDoubleLE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入小端序的64位双浮点型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 8。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 8. Received value is: \[offset\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(8); let result = buf.writeDoubleLE(123.456, 0); console.info("result = " + result); // 输出结果：result = 8 ``` #### writeFloatBE writeFloatBE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入大端序的32位浮点型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 4。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 4. Received value is: \[offset\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(8); let result = buf.writeFloatBE(0xcafebabe, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### writeFloatLE writeFloatLE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入小端序的32位浮点型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 4。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |10200001|The value of "offset" is out of range. It must be \>= 0 and \<= buf.length - 4. Received value is: \[offset\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(8); let result = buf.writeFloatLE(0xcafebabe, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### writeInt8 writeInt8(value: number, offset?: number): number 在Buffer对象的offset偏移处写入8位有符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 1。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(2); let result = buf.writeInt8(2, 0); console.info("result = " + result); // 输出结果：result = 1 let result1 = buf.writeInt8(-2, 1); console.info("result1 = " + result1); // 输出结果：result1 = 2 ``` #### writeInt16BE writeInt16BE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入大端序的16位有符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 2。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(2); let result = buf.writeInt16BE(0x0102, 0); console.info("result = " + result); // 输出结果：result = 2 ``` #### writeInt16LE writeInt16LE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入小端序的16位有符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 2。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(2); let result = buf.writeInt16LE(0x0304, 0); console.info("result = " + result); // 输出结果：result = 2 ``` #### writeInt32BE writeInt32BE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入大端序的32位有符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 4。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(4); let result = buf.writeInt32BE(0x01020304, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### writeInt32LE writeInt32LE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入小端序的32位有符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 4。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(4); let result = buf.writeInt32LE(0x05060708, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### writeIntBE writeIntBE(value: number, offset: number, byteLength: number): number 在Buffer对象的offset偏移处写入大端序的有符号数据，字节长度为byteLength。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:-----|:-|:----------------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|是|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - byteLength。| |byteLength|number|是|要写入的字节数。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(6); let result = buf.writeIntBE(0x1234567890ab, 0, 6); console.info("result = " + result); // 输出结果：result = 6 ``` #### writeIntLE writeIntLE(value: number, offset: number, byteLength: number): number 在Buffer对象的offset偏移处写入小端序的有符号数据，字节长度为byteLength。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:-----|:-|:----------------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|是|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - byteLength。| |byteLength|number|是|要写入的字节数。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(6); let result = buf.writeIntLE(0x1234567890ab, 0, 6); console.info("result = " + result); // 输出结果：result = 6 ``` #### writeUInt8 writeUInt8(value: number, offset?: number): number 在Buffer对象的offset偏移处写入8位无符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 1。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(4); let result = buf.writeUInt8(0x3, 0); console.info("result = " + result); // 输出结果：result = 1 let result1 = buf.writeUInt8(0x4, 1); console.info("result1 = " + result1); // 输出结果：result1 = 2 let result2 = buf.writeUInt8(0x23, 2); console.info("result2 = " + result2); // 输出结果：result2 = 3 let result3 = buf.writeUInt8(0x42, 3); console.info("result3 = " + result3); // 输出结果：result3 = 4 ``` #### writeUInt16BE writeUInt16BE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入大端序的16位无符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值为0。取值范围：0 \<= offset \<= Buffer.length - 2。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(4); let result = buf.writeUInt16BE(0xdead, 0); console.info("result = " + result); // 输出结果：result = 2 let result1 = buf.writeUInt16BE(0xbeef, 2); console.info("result1 = " + result1); // 输出结果：result1 = 4 ``` #### writeUInt16LE writeUInt16LE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入小端序的16位无符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 2。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(4); let result = buf.writeUInt16LE(0xdead, 0); console.info("result = " + result); // 输出结果：result = 2 let result1 = buf.writeUInt16LE(0xbeef, 2); console.info("result1 = " + result1); // 输出结果：result1 = 4 ``` #### writeUInt32BE writeUInt32BE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入大端序的32位无符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 4。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(4); let result = buf.writeUInt32BE(0xfeedface, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### writeUInt32LE writeUInt32LE(value: number, offset?: number): number 在Buffer对象的offset偏移处写入小端序的32位无符号整型数据。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:-----|:-----|:-|:-------------------------------------------------| |value|number|是|写入Buffer对象的数据。| |offset|number|否|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - 4。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(4); let result = buf.writeUInt32LE(0xfeedface, 0); console.info("result = " + result); // 输出结果：result = 4 ``` #### writeUIntBE writeUIntBE(value: number, offset: number, byteLength: number): number 在Buffer对象的offset偏移处写入大端序的无符号数据，字节长度为byteLength。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:-----|:-|:----------------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|是|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - byteLength。| |byteLength|number|是|要写入的字节数。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(6); let result = buf.writeUIntBE(0x1234567890ab, 0, 6); console.info("result = " + result); // 输出结果：result = 6 ``` #### writeUIntLE writeUIntLE(value: number, offset: number, byteLength: number): number 在Buffer对象的offset偏移处写入小端序的无符号数据，字节长度为byteLength。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:---------|:-----|:-|:----------------------------------------------------------| |value|number|是|写入Buffer的数据。| |offset|number|是|偏移量。默认值：0。取值范围：0 \<= offset \<= Buffer.length - byteLength。| |byteLength|number|是|要写入的字节数。| 返回值： |类型|说明| |:-----|:-----------------| |number|偏移量offset加上写入的字节数。| 错误码： 以下错误码的详细介绍请参见[语言基础类库错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-utils)。 |错误码ID|错误信息| |:-------|:----------------------------------------------------------------------------------------------------------------------------| |10200001|The value of "\[param\]" is out of range. It must be \>= \[left range\] and \<= \[right range\]. Received value is: \[param\]| 示例： ``` import { buffer } from '@kit.ArkTS'; let buf = buffer.allocUninitializedFromPool(6); let result = buf.writeUIntLE(0x1234567890ab, 0, 6); console.info("result = " + result); // 输出结果：result = 6 ``` #### Blob #### 属性 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang |名称|类型|只读|可选|说明| |:---|:-----|:-|:-|:------------| |size|number|是|否|Blob实例的总字节大小。| |type|string|是|否|Blob实例的内容类型。| #### constructor constructor(sources: string\[\] \| ArrayBuffer\[\] \| TypedArray\[\] \| DataView\[\] \| Blob\[\] , options?: Object) Blob的构造函数。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:------|:--------------------------------------------------------------------------|:-|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |sources|string\[\] \| ArrayBuffer\[\] \| TypedArray\[\] \| DataView\[\] \| Blob\[\]|是|Blob实例的数据源。| |options|Object|否|options: - endings：含义为结束符'\\n'的字符串如何被输出，为'transparent'或'native'。native代表行结束符会跟随系统。'transparent'代表会保持Blob中保存的结束符不变。此参数非必填，默认值为'transparent'。 - type：Blob内容类型。其目的是让类型传达数据的MIME媒体类型，但是不执行类型格式的验证。此参数非必填，默认参数为''。| 示例： ``` import { buffer } from '@kit.ArkTS'; let blob: buffer.Blob = new buffer.Blob(['a', 'b', 'c']); class option { endings: string = ""; type: string = ""; } let o1: option = {endings:'native', type: 'MIME'} let blob1: buffer.Blob = new buffer.Blob(['a', 'b', 'c'], o1); ``` #### arrayBuffer arrayBuffer(): Promise\ 将Blob数据放入ArrayBuffer中返回，使用Promise进行异步回调。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:---------------------|:--------------------------------| |Promise\|Promise对象，返回包含Blob数据的ArrayBuffer。| 示例： ``` import { buffer } from '@kit.ArkTS'; let blob: buffer.Blob = new buffer.Blob(['a', 'b', 'c']); let pro = blob.arrayBuffer(); pro.then((val: ArrayBuffer) => { let uint8Array: Uint8Array = new Uint8Array(val); console.info(uint8Array.toString()); // 输出结果：97,98,99 }); ``` #### slice slice(start?: number, end?: number, type?: string): Blob 创建并返回一个包含原Blob对象中指定长度数据的新Blob对象。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 参数： |参数名|类型|必填|说明| |:----|:-----|:-|:----------------------| |start|number|否|起始位置。默认值为0。| |end|number|否|结束位置。默认值为原Blob对象中的数据长度。| |type|string|否|内容类型。默认值为''。| 返回值： |类型|说明| |:---|:----------| |Blob|新的Blob实例对象。| 示例： ``` import { buffer } from '@kit.ArkTS'; let blob: buffer.Blob = new buffer.Blob(['a', 'b', 'c']); let blob2 = blob.slice(0, 2); let blob3 = blob.slice(0, 2, "MIME"); console.info("type:", blob3.type); // type: MIME ``` #### text text(): Promise\ 使用utf8解码并返回字符串。使用Promise进行异步回调。 元服务API：从API version 11开始，该接口支持在元服务中使用。 系统能力： SystemCapability.Utils.Lang 返回值： |类型|说明| |:----------------|:------------------------| |Promise\|Promise对象，返回以utf8解码后的字符串。| 示例： ``` import { buffer } from '@kit.ArkTS'; let blob: buffer.Blob = new buffer.Blob(['a', 'b', 'c']); let pro = blob.text(); pro.then((val: string) => { console.info(val); // 输出结果：abc }); ```