提交 471201ce 编写于 作者: L lengchangjing

add buffer exception info

Signed-off-by: Nlengchangjing <lengchangjing@huawei.com>
上级 370c8642
...@@ -25,6 +25,40 @@ import buffer from '@ohos.buffer'; ...@@ -25,6 +25,40 @@ import buffer from '@ohos.buffer';
| buffer | ArrayBuffer | 是 | 否 | ArrayBuffer对象。 | | buffer | ArrayBuffer | 是 | 否 | ArrayBuffer对象。 |
| byteOffset | number | 是 | 否 | 当前buffer所在内存池的偏移量。 | | byteOffset | number | 是 | 否 | 当前buffer所在内存池的偏移量。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200013 | Cannot set property ${propertyName} of Buffer which has only a getter. |
**示例:**
```ts
import buffer from '@ohos.buffer';
let buf = buffer.from("1236");
try {
buf.length = 10;
} catch (err) {
console.log("set length exception: " + JSON.stringify(err));
}
let buf1 = buffer.from("123");
try {
buf.buffer = buf1;
} catch (err) {
console.log("set buffer exception: " + JSON.stringify(err));
}
try {
buf.byteOffset = 3;
} catch (err) {
console.log("set byteOffset exception: " + JSON.stringify(err));
}
```
### alloc ### alloc
alloc(size: number, fill?: string | Buffer | number, encoding?: BufferEncoding): Buffer alloc(size: number, fill?: string | Buffer | number, encoding?: BufferEncoding): Buffer
...@@ -55,6 +89,12 @@ import buffer from '@ohos.buffer'; ...@@ -55,6 +89,12 @@ import buffer from '@ohos.buffer';
let buf1 = buffer.alloc(5); let buf1 = buffer.alloc(5);
let buf2 = buffer.alloc(5, 'a'); let buf2 = buffer.alloc(5, 'a');
let buf3 = buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64'); let buf3 = buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64');
try {
let buf = buffer.alloc(-5);
} catch (err) {
console.log("alloc exception: " + JSON.stringify(err));
}
``` ```
### allocUninitializedFromPool ### allocUninitializedFromPool
...@@ -85,6 +125,12 @@ import buffer from '@ohos.buffer'; ...@@ -85,6 +125,12 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(10); let buf = buffer.allocUninitializedFromPool(10);
buf.fill(0); buf.fill(0);
try {
let buf = buffer.allocUninitializedFromPool(-5);
} catch (err) {
console.log("allocUninitializedFromPool exception: " + JSON.stringify(err));
}
``` ```
### allocUninitialized ### allocUninitialized
...@@ -114,6 +160,12 @@ import buffer from '@ohos.buffer'; ...@@ -114,6 +160,12 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitialized(10); let buf = buffer.allocUninitialized(10);
buf.fill(0); buf.fill(0);
try {
let buf = buffer.allocUninitialized(-5);
} catch (err) {
console.log("allocUninitialized exception: " + JSON.stringify(err));
}
``` ```
### byteLength ### byteLength
...@@ -145,6 +197,12 @@ import buffer from '@ohos.buffer'; ...@@ -145,6 +197,12 @@ import buffer from '@ohos.buffer';
let str = '\u00bd + \u00bc = \u00be'; let str = '\u00bd + \u00bc = \u00be';
console.log(`${str}: ${str.length} characters, ${buffer.byteLength(str, 'utf-8')} bytes`); console.log(`${str}: ${str.length} characters, ${buffer.byteLength(str, 'utf-8')} bytes`);
// 打印: ½ + ¼ = ¾: 9 characters, 12 bytes // 打印: ½ + ¼ = ¾: 9 characters, 12 bytes
try {
let byteLen = buffer.byteLength(10);
} catch (err) {
console.log("byteLength exception: " + JSON.stringify(err));
}
``` ```
### compare ### compare
...@@ -180,6 +238,12 @@ let res = buf1.compare(buf2); ...@@ -180,6 +238,12 @@ let res = buf1.compare(buf2);
console.log(Number(res).toString()); console.log(Number(res).toString());
// 打印 1 // 打印 1
try {
let res = buffer.compare(10, buf2);
} catch (err) {
console.log("compare exception: " + JSON.stringify(err));
}
``` ```
### concat ### concat
...@@ -203,6 +267,14 @@ concat(list: Buffer[] | Uint8Array[], totalLength?: number): Buffer ...@@ -203,6 +267,14 @@ concat(list: Buffer[] | Uint8Array[], totalLength?: number): Buffer
| -------- | -------- | | -------- | -------- |
| Buffer | 返回新Buffer的实例。 | | Buffer | 返回新Buffer的实例。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "totalLength" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -212,6 +284,18 @@ let buf1 = buffer.from("1234"); ...@@ -212,6 +284,18 @@ let buf1 = buffer.from("1234");
let buf2 = buffer.from("abcd"); let buf2 = buffer.from("abcd");
let buf = buffer.concat([buf1, buf2]); let buf = buffer.concat([buf1, buf2]);
console.log(buf.toString('hex')); // 3132333461626364 console.log(buf.toString('hex')); // 3132333461626364
try {
buf = buffer.concat("test string");
} catch (err) {
console.log("concat exception: " + JSON.stringify(err));
}
try {
buf = buffer.concat([buf1, buf2], -1);
} catch (err) {
console.log("concat exception: " + JSON.stringify(err));
}
``` ```
### from ### from
...@@ -241,6 +325,12 @@ import buffer from '@ohos.buffer'; ...@@ -241,6 +325,12 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x62, 0x75, 0x66, 0x66, 0x65, 0x72]); let buf = buffer.from([0x62, 0x75, 0x66, 0x66, 0x65, 0x72]);
console.log(buf.toString('hex')); // 627566666572 console.log(buf.toString('hex')); // 627566666572
try {
const buf = buffer.from(10);
} catch (err) {
console.log("from exception: " + JSON.stringify(err));
}
``` ```
### from ### from
...@@ -265,6 +355,14 @@ from(arrayBuffer: ArrayBuffer | SharedArrayBuffer, byteOffset?: number, length?: ...@@ -265,6 +355,14 @@ from(arrayBuffer: ArrayBuffer | SharedArrayBuffer, byteOffset?: number, length?:
| -------- | -------- | | -------- | -------- |
| Buffer | 返回一个共享内存的Buffer实例。 | | Buffer | 返回一个共享内存的Buffer实例。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[byteOffset/length]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -272,6 +370,12 @@ import buffer from '@ohos.buffer'; ...@@ -272,6 +370,12 @@ import buffer from '@ohos.buffer';
let ab = new ArrayBuffer(10); let ab = new ArrayBuffer(10);
let buf = buffer.from(ab, 0, 2); let buf = buffer.from(ab, 0, 2);
try {
const buf = buffer.from(arrayBuffer, 6, 1);
} catch (err) {
console.log("from exception: " + JSON.stringify(err));
}
``` ```
### from ### from
...@@ -301,6 +405,12 @@ import buffer from '@ohos.buffer'; ...@@ -301,6 +405,12 @@ import buffer from '@ohos.buffer';
let buf1 = buffer.from('buffer'); let buf1 = buffer.from('buffer');
let buf2 = buffer.from(buf1); let buf2 = buffer.from(buf1);
try {
const buf = buffer.from(10);
} catch (err) {
console.log("from exception: " + JSON.stringify(err));
}
``` ```
### from ### from
...@@ -331,6 +441,12 @@ from(object: Object, offsetOrEncoding: number | string, length: number): Buffer ...@@ -331,6 +441,12 @@ from(object: Object, offsetOrEncoding: number | string, length: number): Buffer
import buffer from '@ohos.buffer'; import buffer from '@ohos.buffer';
let buf = buffer.from(new String('this is a test')); let buf = buffer.from(new String('this is a test'));
try {
const buf = buffer.from(10, 0, 1);
} catch (err) {
console.log("from exception: " + JSON.stringify(err));
}
``` ```
### from ### from
...@@ -364,6 +480,12 @@ let buf2 = buffer.from('7468697320697320612074c3a97374', 'hex'); ...@@ -364,6 +480,12 @@ let buf2 = buffer.from('7468697320697320612074c3a97374', 'hex');
console.log(buf1.toString()); // 打印: this is a test console.log(buf1.toString()); // 打印: this is a test
console.log(buf2.toString()); console.log(buf2.toString());
try {
const buf = buffer.from("test string", "utf9");
} catch (err) {
console.log("from exception: " + JSON.stringify(err));
}
``` ```
...@@ -465,6 +587,13 @@ let buf2 = buffer.from([5, 6, 7, 8, 9, 1, 2, 3, 4]); ...@@ -465,6 +587,13 @@ let buf2 = buffer.from([5, 6, 7, 8, 9, 1, 2, 3, 4]);
console.log(buf1.compare(buf2, 5, 9, 0, 4).toString()); // 打印: 0 console.log(buf1.compare(buf2, 5, 9, 0, 4).toString()); // 打印: 0
console.log(buf1.compare(buf2, 0, 6, 4).toString()); // 打印: -1 console.log(buf1.compare(buf2, 0, 6, 4).toString()); // 打印: -1
console.log(buf1.compare(buf2, 5, 6, 5).toString()); // 打印: 1 console.log(buf1.compare(buf2, 5, 6, 5).toString()); // 打印: 1
let buf = buffer.from("1236");
try {
let res = buf.compare(10);
} catch (err) {
console.log("compare exception: " + JSON.stringify(err));
}
``` ```
### copy ### copy
...@@ -490,6 +619,14 @@ copy(target: Buffer| Uint8Array, targetStart?: number, sourceStart?: number, sou ...@@ -490,6 +619,14 @@ copy(target: Buffer| Uint8Array, targetStart?: number, sourceStart?: number, sou
| -------- | -------- | | -------- | -------- |
| number | 复制的字节总长度。 | | number | 复制的字节总长度。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[targetStart/sourceStart/sourceEnd]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -505,6 +642,21 @@ for (let i = 0; i < 26; i++) { ...@@ -505,6 +642,21 @@ for (let i = 0; i < 26; i++) {
buf1.copy(buf2, 8, 16, 20); buf1.copy(buf2, 8, 16, 20);
console.log(buf2.toString('ascii', 0, 25)); console.log(buf2.toString('ascii', 0, 25));
// 打印: !!!!!!!!qrst!!!!!!!!!!!!! // 打印: !!!!!!!!qrst!!!!!!!!!!!!!
let buf3 = buffer.from("123656");
try {
let num = buf3.copy(10);
} catch (err) {
console.log("copy exception: " + JSON.stringify(err));
}
let buf4 = buffer.from("123656");
let buf5 = buffer.from("1235");
try {
let num = buf4.copy(buf5, -1);
} catch (err) {
console.log("copy exception: " + JSON.stringify(err));
}
``` ```
### entries ### entries
...@@ -558,6 +710,11 @@ let buf3 = buffer.from('ABCD'); ...@@ -558,6 +710,11 @@ let buf3 = buffer.from('ABCD');
console.log(buf1.equals(buf2).toString()); // 打印: true console.log(buf1.equals(buf2).toString()); // 打印: true
console.log(buf1.equals(buf3).toString()); // 打印: false console.log(buf1.equals(buf3).toString()); // 打印: false
try {
let res = buf1.equals("1236");
} catch (err) {
console.log("equals exception: " + JSON.stringify(err));
}
``` ```
### fill ### fill
...@@ -583,6 +740,14 @@ fill(value: string | Buffer | Uint8Array | number, offset?: number, end?: number ...@@ -583,6 +740,14 @@ fill(value: string | Buffer | Uint8Array | number, offset?: number, end?: number
| -------- | -------- | | -------- | -------- |
| Buffer | 填充后的Buffer实例。 | | Buffer | 填充后的Buffer实例。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[offset/end]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -590,6 +755,12 @@ import buffer from '@ohos.buffer'; ...@@ -590,6 +755,12 @@ import buffer from '@ohos.buffer';
let b = buffer.allocUninitializedFromPool(50).fill('h'); let b = buffer.allocUninitializedFromPool(50).fill('h');
console.log(b.toString()); console.log(b.toString());
try {
let buf = buffer.alloc(3).fill("$*$", -1);
} catch (err) {
console.log("fill exception: " + JSON.stringify(err));
}
``` ```
...@@ -623,6 +794,13 @@ import buffer from '@ohos.buffer'; ...@@ -623,6 +794,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.from('this is a buffer'); let buf = buffer.from('this is a buffer');
console.log(buf.includes('this').toString()); // 打印: true console.log(buf.includes('this').toString()); // 打印: true
console.log(buf.includes('be').toString()); // 打印: false console.log(buf.includes('be').toString()); // 打印: false
let buf1 = buffer.from("13236");
try {
let flag = buf1.includes(true);
} catch (err) {
console.log("includes exception: " + JSON.stringify(err));
}
``` ```
### indexOf ### indexOf
...@@ -655,6 +833,19 @@ import buffer from '@ohos.buffer'; ...@@ -655,6 +833,19 @@ import buffer from '@ohos.buffer';
let buf = buffer.from('this is a buffer'); let buf = buffer.from('this is a buffer');
console.log(buf.indexOf('this').toString()); // 打印: 0 console.log(buf.indexOf('this').toString()); // 打印: 0
console.log(buf.indexOf('is').toString()); // 打印: 2 console.log(buf.indexOf('is').toString()); // 打印: 2
let buf1 = buffer.from("13236");
try {
let index = buf1.indexOf(true);
} catch (err) {
console.log("indexOf exception: " + JSON.stringify(err));
}
try {
let index1 = buf1.indexOf("a", "utf9");
} catch (err) {
console.log("indexOf exception: " + JSON.stringify(err));
}
``` ```
### keys ### keys
...@@ -712,6 +903,20 @@ import buffer from '@ohos.buffer'; ...@@ -712,6 +903,20 @@ import buffer from '@ohos.buffer';
let buf = buffer.from('this buffer is a buffer'); let buf = buffer.from('this buffer is a buffer');
console.log(buf.lastIndexOf('this').toString()); // 打印: 0 console.log(buf.lastIndexOf('this').toString()); // 打印: 0
console.log(buf.lastIndexOf('buffer').toString()); // 打印: 17 console.log(buf.lastIndexOf('buffer').toString()); // 打印: 17
let buf1 = buffer.from("13236");
try {
let index = buf1.lastIndexOf(true);
} catch (err) {
console.log("lastIndexOf exception: " + JSON.stringify(err));
}
try {
let index1 = buf1.lastIndexOf("a", "utf9");
} catch (err) {
console.log("lastIndexOf exception: " + JSON.stringify(err));
}
``` ```
...@@ -735,6 +940,14 @@ readBigInt64BE(offset?: number): bigint ...@@ -735,6 +940,14 @@ readBigInt64BE(offset?: number): bigint
| -------- | -------- | | -------- | -------- |
| bigint | 读取出的内容。 | | bigint | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -743,6 +956,14 @@ import buffer from '@ohos.buffer'; ...@@ -743,6 +956,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70,
0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]); 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
console.log(buf.readBigInt64BE(0).toString()); console.log(buf.readBigInt64BE(0).toString());
let buf1 = buffer.allocUninitializedFromPool(8);
buf1.writeBigInt64BE(0x0102030405060708n, 0);
try {
let ref = buf1.readBigInt64BE(1).toString(16);
} catch (err) {
console.log("readBigInt64BE exception: " + JSON.stringify(err));
}
``` ```
### readBigInt64LE ### readBigInt64LE
...@@ -765,6 +986,14 @@ readBigInt64LE(offset?: number): bigint ...@@ -765,6 +986,14 @@ readBigInt64LE(offset?: number): bigint
| -------- | -------- | | -------- | -------- |
| bigint | 读取出的内容。 | | bigint | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -773,6 +1002,14 @@ import buffer from '@ohos.buffer'; ...@@ -773,6 +1002,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70,
0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]); 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
console.log(buf.readBigInt64LE(0).toString()); console.log(buf.readBigInt64LE(0).toString());
let buf1 = buffer.allocUninitializedFromPool(8);
buf1.writeBigInt64BE(0x0102030405060708n, 0);
try {
let ref = buf1.readBigInt64LE(1).toString(16);
} catch (err) {
console.log("readBigInt64LE exception: " + JSON.stringify(err));
}
``` ```
### readBigUInt64BE ### readBigUInt64BE
...@@ -795,6 +1032,14 @@ readBigUInt64BE(offset?: number): bigint ...@@ -795,6 +1032,14 @@ readBigUInt64BE(offset?: number): bigint
| -------- | -------- | | -------- | -------- |
| bigint | 读取出的内容。 | | bigint | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -803,6 +1048,14 @@ import buffer from '@ohos.buffer'; ...@@ -803,6 +1048,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70,
0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]); 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
console.log(buf.readBigUInt64BE(0).toString()); console.log(buf.readBigUInt64BE(0).toString());
let buf1 = buffer.allocUninitializedFromPool(8);
buf1.writeBigUInt64BE(0xdecafafecacefaden, 0);
try {
let ref = buf1.readBigUInt64BE(1).toString(16);
} catch (err) {
console.log("readBigUInt64BE exception: " + JSON.stringify(err));
}
``` ```
### readBigUInt64LE ### readBigUInt64LE
...@@ -825,6 +1078,14 @@ readBigUInt64LE(offset?: number): bigint ...@@ -825,6 +1078,14 @@ readBigUInt64LE(offset?: number): bigint
| -------- | -------- | | -------- | -------- |
| bigint | 读取出的内容。 | | bigint | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -833,6 +1094,14 @@ import buffer from '@ohos.buffer'; ...@@ -833,6 +1094,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70, let buf = buffer.from([0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x70,
0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]); 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78]);
console.log(buf.readBigUInt64LE(0).toString()); console.log(buf.readBigUInt64LE(0).toString());
let buf1 = buffer.allocUninitializedFromPool(8);
buf1.writeBigUInt64BE(0xdecafafecacefaden, 0);
try {
let ref = buf1.readBigUInt64LE(1).toString(16);
} catch (err) {
console.log("readBigUInt64LE exception: " + JSON.stringify(err));
}
``` ```
### readDoubleBE ### readDoubleBE
...@@ -855,6 +1124,14 @@ readDoubleBE(offset?: number): number ...@@ -855,6 +1124,14 @@ readDoubleBE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -862,6 +1139,14 @@ import buffer from '@ohos.buffer'; ...@@ -862,6 +1139,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]); let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
console.log(buf.readDoubleBE(0).toString()); console.log(buf.readDoubleBE(0).toString());
let buf1 = buffer.allocUninitializedFromPool(8);
buf1.writeDoubleBE(123.456, 0);
try {
let ref = buf1.readDoubleBE(1);
} catch (err) {
console.log("readDoubleBE exception: " + JSON.stringify(err));
}
``` ```
### readDoubleLE ### readDoubleLE
...@@ -884,6 +1169,14 @@ readDoubleLE(offset?: number): number ...@@ -884,6 +1169,14 @@ readDoubleLE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -891,6 +1184,14 @@ import buffer from '@ohos.buffer'; ...@@ -891,6 +1184,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]); let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
console.log(buf.readDoubleLE(0).toString()); console.log(buf.readDoubleLE(0).toString());
let buf1 = buffer.allocUninitializedFromPool(8);
buf1.writeDoubleLE(123.456, 0);
try {
let ref = buf1.readDoubleLE(1);
} catch (err) {
console.log("readDoubleLE exception: " + JSON.stringify(err));
}
``` ```
### readFloatBE ### readFloatBE
...@@ -913,6 +1214,14 @@ readFloatBE(offset?: number): number ...@@ -913,6 +1214,14 @@ readFloatBE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -920,6 +1229,14 @@ import buffer from '@ohos.buffer'; ...@@ -920,6 +1229,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]); let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
console.log(buf.readFloatBE(0).toString()); console.log(buf.readFloatBE(0).toString());
let buf1 = buffer.allocUninitializedFromPool(4);
buf1.writeFloatBE(0xcabcbcbc, 0);
try {
let ref = buf1.readFloatBE(1).toString(16);
} catch (err) {
console.log("readFloatBE exception: " + JSON.stringify(err));
}
``` ```
### readFloatLE ### readFloatLE
...@@ -942,6 +1259,14 @@ readFloatLE(offset?: number): number ...@@ -942,6 +1259,14 @@ readFloatLE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -949,6 +1274,14 @@ import buffer from '@ohos.buffer'; ...@@ -949,6 +1274,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]); let buf = buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
console.log(buf.readFloatLE(0).toString()); console.log(buf.readFloatLE(0).toString());
let buf1 = buffer.allocUninitializedFromPool(4);
buf1.writeFloatLE(0xcabcbcbc, 0);
try {
let ref = buf1.readFloatLE(1).toString(16);
} catch (err) {
console.log("readFloatLE exception: " + JSON.stringify(err));
}
``` ```
### readInt8 ### readInt8
...@@ -971,6 +1304,14 @@ readInt8(offset?: number): number ...@@ -971,6 +1304,14 @@ readInt8(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -979,6 +1320,14 @@ import buffer from '@ohos.buffer'; ...@@ -979,6 +1320,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([-1, 5]); let buf = buffer.from([-1, 5]);
console.log(buf.readInt8(0).toString()); // 打印: -1 console.log(buf.readInt8(0).toString()); // 打印: -1
console.log(buf.readInt8(1).toString()); // 打印: 5 console.log(buf.readInt8(1).toString()); // 打印: 5
let buf1 = buffer.allocUninitializedFromPool(2);
buf1.writeInt8(0x12);
try {
let ref = buf1.readInt8(2).toString(16);
} catch (err) {
console.log("readInt8 exception: " + JSON.stringify(err));
}
``` ```
### readInt16BE ### readInt16BE
...@@ -1001,6 +1350,14 @@ readInt16BE(offset?: number): number ...@@ -1001,6 +1350,14 @@ readInt16BE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1008,6 +1365,14 @@ import buffer from '@ohos.buffer'; ...@@ -1008,6 +1365,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0, 5]); let buf = buffer.from([0, 5]);
console.log(buf.readInt16BE(0).toString()); // 打印: 5 console.log(buf.readInt16BE(0).toString()); // 打印: 5
let buf1 = buffer.alloc(2);
buf1.writeInt16BE(0x1234, 0);
try {
let ref = buf1.readInt16BE(1).toString(16);
} catch (err) {
console.log("readInt16BE exception: " + JSON.stringify(err));
}
``` ```
### readInt16LE ### readInt16LE
...@@ -1030,6 +1395,14 @@ readInt16LE(offset?: number): number ...@@ -1030,6 +1395,14 @@ readInt16LE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1037,6 +1410,14 @@ import buffer from '@ohos.buffer'; ...@@ -1037,6 +1410,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0, 5]); let buf = buffer.from([0, 5]);
console.log(buf.readInt16LE(0).toString()); // 打印: 1280 console.log(buf.readInt16LE(0).toString()); // 打印: 1280
let buf1 = buffer.alloc(2);
buf1.writeInt16BE(0x1234, 0);
try {
let ref = buf1.readInt16LE(1);
} catch (err) {
console.log("readInt16LE exception: " + JSON.stringify(err));
}
``` ```
### readInt32BE ### readInt32BE
...@@ -1059,6 +1440,14 @@ readInt32BE(offset?: number): number ...@@ -1059,6 +1440,14 @@ readInt32BE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1066,6 +1455,14 @@ import buffer from '@ohos.buffer'; ...@@ -1066,6 +1455,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0, 0, 0, 5]); let buf = buffer.from([0, 0, 0, 5]);
console.log(buf.readInt32BE(0).toString()); // 打印: 5 console.log(buf.readInt32BE(0).toString()); // 打印: 5
let buf1 = buffer.alloc(4);
buf1.writeInt32BE(0x12345678, 0);
try {
let ref = buf1.readInt32BE(1);
} catch (err) {
console.log("readInt32BE exception: " + JSON.stringify(err));
}
``` ```
### readInt32LE ### readInt32LE
...@@ -1088,6 +1485,14 @@ readInt32LE(offset?: number): number ...@@ -1088,6 +1485,14 @@ readInt32LE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1095,6 +1500,14 @@ import buffer from '@ohos.buffer'; ...@@ -1095,6 +1500,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0, 0, 0, 5]); let buf = buffer.from([0, 0, 0, 5]);
console.log(buf.readInt32LE(0).toString()); // 打印: 83886080 console.log(buf.readInt32LE(0).toString()); // 打印: 83886080
let buf1 = buffer.alloc(4);
buf1.writeInt32BE(0x12345678, 0);
try {
let ref = buf1.readInt32LE(1);
} catch (err) {
console.log("readInt32LE exception: " + JSON.stringify(err));
}
``` ```
### readIntBE ### readIntBE
...@@ -1119,6 +1532,14 @@ readIntBE(offset: number, byteLength: number): number ...@@ -1119,6 +1532,14 @@ readIntBE(offset: number, byteLength: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取的内容。 | | number | 读取的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[offset/byteLength]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1127,6 +1548,14 @@ import buffer from '@ohos.buffer'; ...@@ -1127,6 +1548,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from("ab"); let buf = buffer.from("ab");
let num = buf.readIntBE(0, 1); let num = buf.readIntBE(0, 1);
console.log(num.toString()); // 97 console.log(num.toString()); // 97
let buf1 = buffer.allocUninitializedFromPool(6);
buf1.writeIntBE(0x123456789011, 0, 6);
try {
let ref = buf1.readIntBE(2, 5).toString(16);
} catch (err) {
console.log("readIntBE exception: " + JSON.stringify(err));
}
``` ```
...@@ -1152,6 +1581,14 @@ readIntLE(offset: number, byteLength: number): number ...@@ -1152,6 +1581,14 @@ readIntLE(offset: number, byteLength: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[offset/byteLength]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1159,6 +1596,14 @@ import buffer from '@ohos.buffer'; ...@@ -1159,6 +1596,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]); let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
console.log(buf.readIntLE(0, 6).toString(16)); console.log(buf.readIntLE(0, 6).toString(16));
let buf1 = buffer.allocUninitializedFromPool(6);
buf1.writeIntLE(0x123456789011, 0, 6);
try {
let ref = buf1.readIntLE(2, 5).toString(16);
} catch (err) {
console.log("readIntBE exception: " + JSON.stringify(err));
}
``` ```
### readUInt8 ### readUInt8
...@@ -1182,6 +1627,14 @@ readUInt8(offset?: number): number ...@@ -1182,6 +1627,14 @@ readUInt8(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1190,6 +1643,14 @@ import buffer from '@ohos.buffer'; ...@@ -1190,6 +1643,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([1, -2]); let buf = buffer.from([1, -2]);
console.log(buf.readUInt8(0).toString()); console.log(buf.readUInt8(0).toString());
console.log(buf.readUInt8(1).toString()); console.log(buf.readUInt8(1).toString());
let buf = buffer.allocUninitializedFromPool(4);
buf.writeUInt8(0x42);
try {
let ref = buf.readUInt8(4).toString(16);
} catch (err) {
console.log("readUInt8 exception: " + JSON.stringify(err));
}
``` ```
### readUInt16BE ### readUInt16BE
...@@ -1213,6 +1674,14 @@ readUInt16BE(offset?: number): number ...@@ -1213,6 +1674,14 @@ readUInt16BE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1221,6 +1690,14 @@ import buffer from '@ohos.buffer'; ...@@ -1221,6 +1690,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x12, 0x34, 0x56]); let buf = buffer.from([0x12, 0x34, 0x56]);
console.log(buf.readUInt16BE(0).toString(16)); console.log(buf.readUInt16BE(0).toString(16));
console.log(buf.readUInt16BE(1).toString(16)); console.log(buf.readUInt16BE(1).toString(16));
let buf1 = buffer.allocUninitializedFromPool(4);
buf1.writeUInt16BE(0x1234, 0);
try {
let ref = buf1.readUInt16BE(3).toString(16);
} catch (err) {
console.log("readUInt16BE exception: " + JSON.stringify(err));
}
``` ```
### readUInt16LE ### readUInt16LE
...@@ -1244,6 +1721,14 @@ readUInt16LE(offset?: number): number ...@@ -1244,6 +1721,14 @@ readUInt16LE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1252,6 +1737,14 @@ import buffer from '@ohos.buffer'; ...@@ -1252,6 +1737,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x12, 0x34, 0x56]); let buf = buffer.from([0x12, 0x34, 0x56]);
console.log(buf.readUInt16LE(0).toString(16)); console.log(buf.readUInt16LE(0).toString(16));
console.log(buf.readUInt16LE(1).toString(16)); console.log(buf.readUInt16LE(1).toString(16));
let buf1 = buffer.allocUninitializedFromPool(4);
buf1.writeUInt16LE(0x1234, 0);
try {
let ref = buf1.readUInt16LE(3).toString(16);
} catch (err) {
console.log("readUInt16LE exception: " + JSON.stringify(err));
}
``` ```
### readUInt32BE ### readUInt32BE
...@@ -1275,6 +1768,14 @@ readUInt32BE(offset?: number): number ...@@ -1275,6 +1768,14 @@ readUInt32BE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1282,6 +1783,14 @@ import buffer from '@ohos.buffer'; ...@@ -1282,6 +1783,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x12, 0x34, 0x56, 0x78]); let buf = buffer.from([0x12, 0x34, 0x56, 0x78]);
console.log(buf.readUInt32BE(0).toString(16)); console.log(buf.readUInt32BE(0).toString(16));
let buf1 = buffer.allocUninitializedFromPool(4);
buf1.writeUInt32BE(0x12345678, 0);
try {
let ref = buf1.readUInt32BE(1).toString(16);
} catch (err) {
console.log("readUInt32BE exception: " + JSON.stringify(err));
}
``` ```
### readUInt32LE ### readUInt32LE
...@@ -1305,6 +1814,14 @@ readUInt32LE(offset?: number): number ...@@ -1305,6 +1814,14 @@ readUInt32LE(offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "offset" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1312,6 +1829,14 @@ import buffer from '@ohos.buffer'; ...@@ -1312,6 +1829,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x12, 0x34, 0x56, 0x78]); let buf = buffer.from([0x12, 0x34, 0x56, 0x78]);
console.log(buf.readUInt32LE(0).toString(16)); console.log(buf.readUInt32LE(0).toString(16));
let buf1 = buffer.allocUninitializedFromPool(4);
buf1.writeUInt32LE(0x12345678, 0);
try {
let ref = buf1.readUInt32LE(1).toString(16);
} catch (err) {
console.log("readUInt32LE exception: " + JSON.stringify(err));
}
``` ```
### readUIntBE ### readUIntBE
...@@ -1336,6 +1861,14 @@ readUIntBE(offset: number, byteLength: number): number ...@@ -1336,6 +1861,14 @@ readUIntBE(offset: number, byteLength: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[offset/byteLength]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1343,6 +1876,14 @@ import buffer from '@ohos.buffer'; ...@@ -1343,6 +1876,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]); let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
console.log(buf.readUIntBE(0, 6).toString(16)); console.log(buf.readUIntBE(0, 6).toString(16));
let buf1 = buffer.allocUninitializedFromPool(4);
buf1.writeUIntBE(0x13141516, 0, 4);
try {
let ref = buf1.readUIntBE(2, 3).toString(16);
} catch (err) {
console.log("readUIntBE exception: " + JSON.stringify(err));
}
``` ```
### readUIntLE ### readUIntLE
...@@ -1367,6 +1908,14 @@ readUIntLE(offset: number, byteLength: number): number ...@@ -1367,6 +1908,14 @@ readUIntLE(offset: number, byteLength: number): number
| -------- | -------- | | -------- | -------- |
| number | 读取出的内容。 | | number | 读取出的内容。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[offset/byteLength]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1374,6 +1923,14 @@ import buffer from '@ohos.buffer'; ...@@ -1374,6 +1923,14 @@ import buffer from '@ohos.buffer';
let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]); let buf = buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
console.log(buf.readUIntLE(0, 6).toString(16)); console.log(buf.readUIntLE(0, 6).toString(16));
let buf1 = buffer.allocUninitializedFromPool(4);
buf1.writeUIntLE(0x13141516, 0, 4);
try {
let ref = buf1.readUIntLE(2, 3).toString(16);
} catch (err) {
console.log("readUIntLE exception: " + JSON.stringify(err));
}
``` ```
### subarray ### subarray
...@@ -1427,6 +1984,14 @@ swap16(): Buffer ...@@ -1427,6 +1984,14 @@ swap16(): Buffer
| -------- | -------- | | -------- | -------- |
| Buffer | 交换之后的Buffer实例。 | | Buffer | 交换之后的Buffer实例。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200009 | Buffer size must be a multiple of 16-bits |
**示例:** **示例:**
```ts ```ts
...@@ -1437,6 +2002,13 @@ console.log(buf1.toString('hex')); // 打印: 0102030405060708 ...@@ -1437,6 +2002,13 @@ console.log(buf1.toString('hex')); // 打印: 0102030405060708
buf1.swap16(); buf1.swap16();
console.log(buf1.toString('hex')); // 打印: 0201040306050807 console.log(buf1.toString('hex')); // 打印: 0201040306050807
let buf2 = buffer.from("132");
try {
buf2.swap16();
} catch (err) {
console.log("swap16 exception: " + JSON.stringify(err));
}
``` ```
### swap32 ### swap32
...@@ -1454,6 +2026,14 @@ swap32(): Buffer ...@@ -1454,6 +2026,14 @@ swap32(): Buffer
| -------- | -------- | | -------- | -------- |
| Buffer | 交换之后的Buffer实例。 | | Buffer | 交换之后的Buffer实例。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200009 | Buffer size must be a multiple of 32-bits |
**示例:** **示例:**
```ts ```ts
...@@ -1464,6 +2044,13 @@ console.log(buf1.toString('hex')); // 打印: 0102030405060708 ...@@ -1464,6 +2044,13 @@ console.log(buf1.toString('hex')); // 打印: 0102030405060708
buf1.swap32(); buf1.swap32();
console.log(buf1.toString('hex')); // 打印: 0403020108070605 console.log(buf1.toString('hex')); // 打印: 0403020108070605
let buf2 = buffer.from("132");
try {
buf2.swap32();
} catch (err) {
console.log("swap32 exception: " + JSON.stringify(err));
}
``` ```
### swap64 ### swap64
...@@ -1481,6 +2068,14 @@ swap64(): Buffer ...@@ -1481,6 +2068,14 @@ swap64(): Buffer
| -------- | -------- | | -------- | -------- |
| Buffer | 交换之后的Buffer实例。 | | Buffer | 交换之后的Buffer实例。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200009 | Buffer size must be a multiple of 64-bits |
**示例:** **示例:**
```ts ```ts
...@@ -1490,6 +2085,13 @@ let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]); ...@@ -1490,6 +2085,13 @@ let buf1 = buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
console.log(buf1.toString('hex')); // 打印: 0102030405060708 console.log(buf1.toString('hex')); // 打印: 0102030405060708
buf1.swap64(); buf1.swap64();
console.log(buf1.toString('hex')); // 打印: 0807060504030201 console.log(buf1.toString('hex')); // 打印: 0807060504030201
let buf2 = buffer.from("1234567");
try {
buf2.swap64();
} catch (err) {
console.log("swap64 exception: " + JSON.stringify(err));
}
``` ```
### toJSON ### toJSON
...@@ -1551,6 +2153,13 @@ for (let i = 0; i < 26; i++) { ...@@ -1551,6 +2153,13 @@ for (let i = 0; i < 26; i++) {
} }
console.log(buf1.toString('utf-8')); console.log(buf1.toString('utf-8'));
// 打印: abcdefghijklmnopqrstuvwxyz // 打印: abcdefghijklmnopqrstuvwxyz
let buf2 = buffer.from("abc");
try {
let str = buf2.toString("utf9");
} catch (err) {
console.log("toString exception: " + JSON.stringify(err));
}
``` ```
### values ### values
...@@ -1602,6 +2211,14 @@ write(str: string, offset?: number, length?: number, encoding?: string): number ...@@ -1602,6 +2211,14 @@ write(str: string, offset?: number, length?: number, encoding?: string): number
| -------- | -------- | | -------- | -------- |
| number | 返回写入的字节数。 | | number | 返回写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[offset/length]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1614,6 +2231,27 @@ console.log(`${len} bytes: ${buf.toString('utf-8', 0, len)}`); ...@@ -1614,6 +2231,27 @@ console.log(`${len} bytes: ${buf.toString('utf-8', 0, len)}`);
let buffer1 = buffer.alloc(10); let buffer1 = buffer.alloc(10);
let length = buffer1.write('abcd', 8); let length = buffer1.write('abcd', 8);
let buf1 = buffer.alloc(8);
try {
let offset1 = buf1.write("abcde", "utf9");
} catch (err) {
console.log("write exception: " + JSON.stringify(err));
}
let buf2 = buffer.alloc(8);
try {
let offset2 = buf2.write(10);
} catch (err) {
console.log("write exception: " + JSON.stringify(err));
}
let buf3 = buffer.alloc(8);
try {
let offset3 = buf3.write("abcde", -1);
} catch (err) {
console.log("write exception: " + JSON.stringify(err));
}
``` ```
### writeBigInt64BE ### writeBigInt64BE
...@@ -1638,6 +2276,14 @@ writeBigInt64BE(value: bigint, offset?: number): number ...@@ -1638,6 +2276,14 @@ writeBigInt64BE(value: bigint, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1645,6 +2291,13 @@ import buffer from '@ohos.buffer'; ...@@ -1645,6 +2291,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(8); let buf = buffer.allocUninitializedFromPool(8);
buf.writeBigInt64BE(0x0102030405060708n, 0); buf.writeBigInt64BE(0x0102030405060708n, 0);
let buf1 = buffer.allocUninitializedFromPool(8);
try {
let ref = buf1.writeBigInt64BE(0x0102030405060708n, 1);
} catch (err) {
console.log("writeBigInt64BE exception: " + JSON.stringify(err));
}
``` ```
### writeBigInt64LE ### writeBigInt64LE
...@@ -1669,6 +2322,14 @@ writeBigInt64LE(value: bigint, offset?: number): number ...@@ -1669,6 +2322,14 @@ writeBigInt64LE(value: bigint, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1676,6 +2337,13 @@ import buffer from '@ohos.buffer'; ...@@ -1676,6 +2337,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(8); let buf = buffer.allocUninitializedFromPool(8);
buf.writeBigInt64LE(0x0102030405060708n, 0); buf.writeBigInt64LE(0x0102030405060708n, 0);
let buf1 = buffer.allocUninitializedFromPool(8);
try {
let ref = buf1.writeBigInt64LE(0x0102030405060708n, 1);
} catch (err) {
console.log("writeBigInt64LE exception: " + JSON.stringify(err));
}
``` ```
### writeBigUInt64BE ### writeBigUInt64BE
...@@ -1700,6 +2368,14 @@ writeBigUInt64BE(value: bigint, offset?: number): number ...@@ -1700,6 +2368,14 @@ writeBigUInt64BE(value: bigint, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1707,6 +2383,13 @@ import buffer from '@ohos.buffer'; ...@@ -1707,6 +2383,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(8); let buf = buffer.allocUninitializedFromPool(8);
buf.writeBigUInt64BE(0xdecafafecacefaden, 0); buf.writeBigUInt64BE(0xdecafafecacefaden, 0);
let buf1 = buffer.allocUninitializedFromPool(8);
try {
let ref = buf1.writeBigUInt64BE(0xdecafafecacefaden, 1);
} catch (err) {
console.log("writeBigUInt64BE exception: " + JSON.stringify(err));
}
``` ```
### writeBigUInt64LE ### writeBigUInt64LE
...@@ -1731,6 +2414,14 @@ writeBigUInt64LE(value: bigint, offset?: number): number ...@@ -1731,6 +2414,14 @@ writeBigUInt64LE(value: bigint, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1738,6 +2429,13 @@ import buffer from '@ohos.buffer'; ...@@ -1738,6 +2429,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(8); let buf = buffer.allocUninitializedFromPool(8);
buf.writeBigUInt64LE(0xdecafafecacefaden, 0); buf.writeBigUInt64LE(0xdecafafecacefaden, 0);
let buf = buffer.allocUninitializedFromPool(8);
try {
let ref = buf.writeBigUInt64LE(0xdecafafecacefaden, 1);
} catch (err) {
console.log("writeBigUInt64LE exception: " + JSON.stringify(err));
}
``` ```
### writeDoubleBE ### writeDoubleBE
...@@ -1762,6 +2460,14 @@ writeDoubleBE(value: number, offset?: number): number ...@@ -1762,6 +2460,14 @@ writeDoubleBE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1769,6 +2475,13 @@ import buffer from '@ohos.buffer'; ...@@ -1769,6 +2475,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(8); let buf = buffer.allocUninitializedFromPool(8);
buf.writeDoubleBE(123.456, 0); buf.writeDoubleBE(123.456, 0);
let buf1 = buffer.allocUninitializedFromPool(8);
try {
let ref = buf1.writeDoubleBE(123.456, 1);
} catch (err) {
console.log("writeDoubleBE exception: " + JSON.stringify(err));
}
``` ```
### writeDoubleLE ### writeDoubleLE
...@@ -1793,6 +2506,14 @@ writeDoubleLE(value: number, offset?: number): number ...@@ -1793,6 +2506,14 @@ writeDoubleLE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1800,6 +2521,13 @@ import buffer from '@ohos.buffer'; ...@@ -1800,6 +2521,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(8); let buf = buffer.allocUninitializedFromPool(8);
buf.writeDoubleLE(123.456, 0); buf.writeDoubleLE(123.456, 0);
let buf = buffer.allocUninitializedFromPool(8);
try {
let ref = buf.writeDoubleLE(123.456, 1);
} catch (err) {
console.log("writeDoubleLE exception: " + JSON.stringify(err));
}
``` ```
### writeFloatBE ### writeFloatBE
...@@ -1824,6 +2552,14 @@ writeFloatBE(value: number, offset?: number): number ...@@ -1824,6 +2552,14 @@ writeFloatBE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1831,6 +2567,13 @@ import buffer from '@ohos.buffer'; ...@@ -1831,6 +2567,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(8); let buf = buffer.allocUninitializedFromPool(8);
buf.writeFloatBE(0xcafebabe, 0); buf.writeFloatBE(0xcafebabe, 0);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeFloatBE(0xcabcbcbc, 5);
} catch (err) {
console.log("writeFloatBE exception: " + JSON.stringify(err));
}
``` ```
...@@ -1856,6 +2599,14 @@ writeFloatLE(value: number, offset?: number): number ...@@ -1856,6 +2599,14 @@ writeFloatLE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1863,6 +2614,13 @@ import buffer from '@ohos.buffer'; ...@@ -1863,6 +2614,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(8); let buf = buffer.allocUninitializedFromPool(8);
buf.writeFloatLE(0xcafebabe, 0); buf.writeFloatLE(0xcafebabe, 0);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeFloatLE(0xcabcbcbc, 5);
} catch (err) {
console.log("writeFloatLE exception: " + JSON.stringify(err));
}
``` ```
### writeInt8 ### writeInt8
...@@ -1887,6 +2645,14 @@ writeInt8(value: number, offset?: number): number ...@@ -1887,6 +2645,14 @@ writeInt8(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1895,6 +2661,13 @@ import buffer from '@ohos.buffer'; ...@@ -1895,6 +2661,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(2); let buf = buffer.allocUninitializedFromPool(2);
buf.writeInt8(2, 0); buf.writeInt8(2, 0);
buf.writeInt8(-2, 1); buf.writeInt8(-2, 1);
let buf1 = buffer.allocUninitializedFromPool(2);
try {
let ref = buf1.writeInt8(2, -1);
} catch (err) {
console.log("writeInt8 exception: " + JSON.stringify(err));
}
``` ```
...@@ -1920,6 +2693,14 @@ writeInt16BE(value: number, offset?: number): number ...@@ -1920,6 +2693,14 @@ writeInt16BE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1927,6 +2708,13 @@ import buffer from '@ohos.buffer'; ...@@ -1927,6 +2708,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(2); let buf = buffer.allocUninitializedFromPool(2);
buf.writeInt16BE(0x0102, 0); buf.writeInt16BE(0x0102, 0);
let buf1 = buffer.alloc(2);
try {
let ref = buf1.writeInt16BE(0x7bca, -1);
} catch (err) {
console.log("writeInt16BE exception: " + JSON.stringify(err));
}
``` ```
...@@ -1952,6 +2740,14 @@ writeInt16LE(value: number, offset?: number): number ...@@ -1952,6 +2740,14 @@ writeInt16LE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1959,6 +2755,13 @@ import buffer from '@ohos.buffer'; ...@@ -1959,6 +2755,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(2); let buf = buffer.allocUninitializedFromPool(2);
buf.writeInt16LE(0x0304, 0); buf.writeInt16LE(0x0304, 0);
let buf1 = buffer.alloc(2);
try {
let ref = buf1.writeInt16LE(0x7bca, -1);
} catch (err) {
console.log("writeInt16LE exception: " + JSON.stringify(err));
}
``` ```
### writeInt32BE ### writeInt32BE
...@@ -1983,6 +2786,14 @@ writeInt32BE(value: number, offset?: number): number ...@@ -1983,6 +2786,14 @@ writeInt32BE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -1990,6 +2801,13 @@ import buffer from '@ohos.buffer'; ...@@ -1990,6 +2801,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(4); let buf = buffer.allocUninitializedFromPool(4);
buf.writeInt32BE(0x01020304, 0); buf.writeInt32BE(0x01020304, 0);
let buf1 = buffer.alloc(4);
try {
let ref = buf1.writeInt32BE(0x12345678, -1);
} catch (err) {
console.log("writeInt32BE exception: " + JSON.stringify(err));
}
``` ```
...@@ -2015,6 +2833,14 @@ writeInt32LE(value: number, offset?: number): number ...@@ -2015,6 +2833,14 @@ writeInt32LE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2022,6 +2848,13 @@ import buffer from '@ohos.buffer'; ...@@ -2022,6 +2848,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(4); let buf = buffer.allocUninitializedFromPool(4);
buf.writeInt32LE(0x05060708, 0); buf.writeInt32LE(0x05060708, 0);
let buf1 = buffer.alloc(4);
try {
let ref = buf1.writeInt32LE(0x12345678, -1);
} catch (err) {
console.log("writeInt32LE exception: " + JSON.stringify(err));
}
``` ```
### writeIntBE ### writeIntBE
...@@ -2047,6 +2880,14 @@ writeIntBE(value: number, offset: number, byteLength: number): number ...@@ -2047,6 +2880,14 @@ writeIntBE(value: number, offset: number, byteLength: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset/byteLength]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2054,6 +2895,13 @@ import buffer from '@ohos.buffer'; ...@@ -2054,6 +2895,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(6); let buf = buffer.allocUninitializedFromPool(6);
buf.writeIntBE(0x1234567890ab, 0, 6); buf.writeIntBE(0x1234567890ab, 0, 6);
let buf1 = buffer.allocUninitializedFromPool(6);
try {
let ref = buf1.writeIntBE(0x1234567890ab, 1, 6);
} catch (err) {
console.log("writeIntBE exception: " + JSON.stringify(err));
}
``` ```
...@@ -2080,6 +2928,14 @@ writeIntLE(value: number, offset: number, byteLength: number): number ...@@ -2080,6 +2928,14 @@ writeIntLE(value: number, offset: number, byteLength: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset/byteLength]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2087,6 +2943,13 @@ import buffer from '@ohos.buffer'; ...@@ -2087,6 +2943,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(6); let buf = buffer.allocUninitializedFromPool(6);
buf.writeIntLE(0x1234567890ab, 0, 6); buf.writeIntLE(0x1234567890ab, 0, 6);
let buf1 = buffer.allocUninitializedFromPool(6);
try {
let ref = buf1.writeIntLE(0x1234567890ab, 1, 6);
} catch (err) {
console.log("writeIntLE exception: " + JSON.stringify(err));
}
``` ```
### writeUInt8 ### writeUInt8
...@@ -2111,6 +2974,14 @@ writeUInt8(value: number, offset?: number): number ...@@ -2111,6 +2974,14 @@ writeUInt8(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2121,6 +2992,13 @@ buf.writeUInt8(0x3, 0); ...@@ -2121,6 +2992,13 @@ buf.writeUInt8(0x3, 0);
buf.writeUInt8(0x4, 1); buf.writeUInt8(0x4, 1);
buf.writeUInt8(0x23, 2); buf.writeUInt8(0x23, 2);
buf.writeUInt8(0x42, 3); buf.writeUInt8(0x42, 3);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeUInt8(0x42, -1);
} catch (err) {
console.log("writeUInt8 exception: " + JSON.stringify(err));
}
``` ```
### writeUInt16BE ### writeUInt16BE
...@@ -2145,6 +3023,14 @@ writeUInt16BE(value: number, offset?: number): number ...@@ -2145,6 +3023,14 @@ writeUInt16BE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2153,6 +3039,13 @@ import buffer from '@ohos.buffer'; ...@@ -2153,6 +3039,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(4); let buf = buffer.allocUninitializedFromPool(4);
buf.writeUInt16BE(0xdead, 0); buf.writeUInt16BE(0xdead, 0);
buf.writeUInt16BE(0xbeef, 2); buf.writeUInt16BE(0xbeef, 2);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeUInt16BE(0xdeadfc, 0);
} catch (err) {
console.log("writeUInt16BE exception: " + JSON.stringify(err));
}
``` ```
### writeUInt16LE ### writeUInt16LE
...@@ -2177,6 +3070,14 @@ writeUInt16LE(value: number, offset?: number): number ...@@ -2177,6 +3070,14 @@ writeUInt16LE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2185,6 +3086,13 @@ import buffer from '@ohos.buffer'; ...@@ -2185,6 +3086,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(4); let buf = buffer.allocUninitializedFromPool(4);
buf.writeUInt16LE(0xdead, 0); buf.writeUInt16LE(0xdead, 0);
buf.writeUInt16LE(0xbeef, 2); buf.writeUInt16LE(0xbeef, 2);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeUInt16LE(0xdeadfc, 0);
} catch (err) {
console.log("writeUInt16LE exception: " + JSON.stringify(err));
}
``` ```
### writeUInt32BE ### writeUInt32BE
...@@ -2209,6 +3117,14 @@ writeUInt32BE(value: number, offset?: number): number ...@@ -2209,6 +3117,14 @@ writeUInt32BE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2216,6 +3132,13 @@ import buffer from '@ohos.buffer'; ...@@ -2216,6 +3132,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(4); let buf = buffer.allocUninitializedFromPool(4);
buf.writeUInt32BE(0xfeedface, 0); buf.writeUInt32BE(0xfeedface, 0);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeUInt32BE(0xfeedface, -1);
} catch (err) {
console.log("writeUInt32BE exception: " + JSON.stringify(err));
}
``` ```
### writeUInt32LE ### writeUInt32LE
...@@ -2240,6 +3163,14 @@ writeUInt32LE(value: number, offset?: number): number ...@@ -2240,6 +3163,14 @@ writeUInt32LE(value: number, offset?: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2247,6 +3178,13 @@ import buffer from '@ohos.buffer'; ...@@ -2247,6 +3178,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(4); let buf = buffer.allocUninitializedFromPool(4);
buf.writeUInt32LE(0xfeedface, 0); buf.writeUInt32LE(0xfeedface, 0);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeUInt32LE(0xfeedface, -1);
} catch (err) {
console.log("writeUInt32LE exception: " + JSON.stringify(err));
}
``` ```
### writeUIntBE ### writeUIntBE
...@@ -2272,6 +3210,14 @@ writeUIntBE(value: number, offset: number, byteLength: number): number ...@@ -2272,6 +3210,14 @@ writeUIntBE(value: number, offset: number, byteLength: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset/byteLength]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2279,6 +3225,13 @@ import buffer from '@ohos.buffer'; ...@@ -2279,6 +3225,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(6); let buf = buffer.allocUninitializedFromPool(6);
buf.writeUIntBE(0x1234567890ab, 0, 6); buf.writeUIntBE(0x1234567890ab, 0, 6);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeUIntBE(0x13141516, 0, 1);
} catch (err) {
console.log("writeUIntBE exception: " + JSON.stringify(err));
}
``` ```
### writeUIntLE ### writeUIntLE
...@@ -2304,6 +3257,14 @@ writeUIntLE(value: number, offset: number, byteLength: number): number ...@@ -2304,6 +3257,14 @@ writeUIntLE(value: number, offset: number, byteLength: number): number
| -------- | -------- | | -------- | -------- |
| number | 写入的字节数。 | | number | 写入的字节数。 |
**错误码:**
以下错误码的详细介绍请参见[buffer错误码](../errorcodes/errorcode-buffer.md)
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 10200001 | The value of "[value/offset/byteLength]" is out of range. |
**示例:** **示例:**
```ts ```ts
...@@ -2311,6 +3272,13 @@ import buffer from '@ohos.buffer'; ...@@ -2311,6 +3272,13 @@ import buffer from '@ohos.buffer';
let buf = buffer.allocUninitializedFromPool(6); let buf = buffer.allocUninitializedFromPool(6);
buf.writeUIntLE(0x1234567890ab, 0, 6); buf.writeUIntLE(0x1234567890ab, 0, 6);
let buf1 = buffer.allocUninitializedFromPool(4);
try {
let ref = buf1.writeUIntLE(0x13141516, 0, 1);
} catch (err) {
console.log("writeUIntLE exception: " + JSON.stringify(err));
}
``` ```
### transcode ### transcode
...@@ -2343,6 +3311,25 @@ import buffer from '@ohos.buffer'; ...@@ -2343,6 +3311,25 @@ import buffer from '@ohos.buffer';
let buf = buffer.alloc(50); let buf = buffer.alloc(50);
let newBuf = buffer.transcode(buffer.from(''), 'utf-8', 'ascii'); let newBuf = buffer.transcode(buffer.from(''), 'utf-8', 'ascii');
console.log(newBuf.toString('ascii')); console.log(newBuf.toString('ascii'));
try {
let buf1 = buffer.transcode(10, "utf8", "ucs2");
} catch (err) {
console.log("transcode exception: " + JSON.stringify(err));
}
let buf2 = buffer.from("测试");
try {
let buf3 = buffer.transcode(buf2, 0, "ucs2");
} catch (err) {
console.log("transcode exception: " + JSON.stringify(err));
}
try {
let buf3 = buffer.transcode(buf2, "utf8", 0);
} catch (err) {
console.log("transcode exception: " + JSON.stringify(err));
}
``` ```
## Blob ## Blob
...@@ -2373,13 +3360,24 @@ Blob的构造函数。 ...@@ -2373,13 +3360,24 @@ Blob的构造函数。
**示例:** **示例:**
```ts
import buffer from '@ohos.buffer';
```ts let blob = new buffer.Blob(['a', 'b', 'c']);
import buffer from '@ohos.buffer'; let blob1 = new buffer.Blob(['a', 'b', 'c'], {endings:'native', type: 'MIME'});
let blob = new buffer.Blob(['a', 'b', 'c']); try {
let blob1 = new buffer.Blob(['a', 'b', 'c'], {endings:'native', type: 'MIME'}); let blob1 = new buffer.Blob(["a", "b", "c"], 10);
``` } catch (err) {
console.log("Blob constructor exception: " + JSON.stringify(err));
}
try {
let blob2 = new buffer.Blob("abc", { type: "new type", endings: "transparent" });
} catch (err) {
console.log("Blob constructor exception: " + JSON.stringify(err));
}
```
### encode ### encode
......
# buffer错误码
## 10200001 参数范围越界错误
**错误信息**
The value of ${param} is out of range.
**错误描述**
调用接口时某个参数超出了其正常范围的取值。
**可能原因**
某个参数取值超出可用范围。
**处理步骤**
检查所传参数是否在可用取值范围内。
## 10200009 Buffer size 错误
**错误信息**
Buffer size must be a multiple of ${size}
**错误描述**
Buffer的长度必须是${size}的整数倍,${size}为16-bits,32-bits或者64-bits。
**可能原因**
Buffer的长度不是${size}的整数倍,${size}为16-bits,32-bits或者64-bits。
**处理步骤**
请检查Buffer的长度值。
## 10200013 只读属性设置错误
**错误信息**
Cannot set property ${propertyName} of Buffer which has only a getter.
**错误描述**
Buffer的属性${propertyName}只读,不能进行设置。
**可能原因**
将${propertyName}放在了等号左边(即对属性值进行设置)。
**处理步骤**
请检查属性${propertyName}是否在等号左边。
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册