> 稳定性: 2 - 稳定的

`string_decoder` 模块提供了一个 API，用于解码 `Buffer` 对象成字符串。它可以通过以下方式被使用：

```js

const StringDecoder = require('string_decoder').StringDecoder;

```

以下例子展示了 `StringDecoder` 类的基本用法。

```js

const StringDecoder = require('string_decoder').StringDecoder;

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').StringDecoder;

const decoder = new StringDecoder('utf8');

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

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

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

```