FilesExpand file tree

master

/

string_decoder.md

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

38 lines (25 loc) · 1.22 KB

master

/

string_decoder.md

Copy path

Top

File metadata and controls

• Code
• Blame

38 lines (25 loc) · 1.22 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

<!--introduced_in=v0.10.0-->

> 稳定性: 2 - 稳定的

`string_decoder` 模块提供了一个 API，用于把 `Buffer` 对象解码成字符串，但会保留编码过的多字节 UTF-8 与 UTF-16 字符。使用以下方法引入：

```js

const { StringDecoder } = require('string_decoder');

```

例子，`StringDecoder` 类的基本用法：

```js

const { StringDecoder } = require('string_decoder');

const decoder = new StringDecoder('utf8');

const cent = Buffer.from([0xC2, 0xA2]);

console.log(decoder.write(cent));

const euro = Buffer.from([0xE2, 0x82, 0xAC]);

console.log(decoder.write(euro));

```

当一个 `Buffer` 实例被写入 `StringDecoder` 实例时，会使用一个内部的 buffer 来确保解码后的字符串不会包含残缺的多字节字符。

残缺的多字节字符会被保存在这个 buffer 中，直到下次调用 `stringDecoder.write()` 或直到 `stringDecoder.end()` 被调用。

例子，欧元符号（`€`）的三个 UTF-8 编码的字节被分成三次操作写入：

```js

const { StringDecoder } = require('string_decoder');

const decoder = new StringDecoder('utf8');

decoder.write(Buffer.from([0xE2]));

decoder.write(Buffer.from([0x82]));

console.log(decoder.end(Buffer.from([0xAC])));

```