string_decoder(字符串解码器)
string_decoder
模块提供了一个 API,用于以保留编码的多字节 UTF-8 和 UTF-16 字符的方式将 Buffer
对象解码为字符串。 它可以使用以下方式访问:
const { StringDecoder } = require('string_decoder');
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
实例时,将使用内部缓冲区来确保已解码的字符串不包含任何不完整的多字节字符。 它们保存在缓冲区中,直到下一次调用 stringDecoder.write()
或调用 stringDecoder.end()
为止。
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])));
StringDecoder 类
new StringDecoder([encoding])
encoding <string> StringDecoder 将使用的字符编码。默认值: 'utf8'。
创建一个新的 StringDecoder 实例。
stringDecoder.end([buffer])
buffer <Buffer> | <TypedArray> | <DataView> 包含要解码的字节的 Buffer、 TypedArray 或 DataView。
返回: <string>
以字符串形式返回存储在内部缓冲区中的任何剩余输入。 表示不完整的 UTF-8 和 UTF-16 字符的字节将替换为适合字符编码的替换字符。
如果提供了 buffer 参数,则在返回剩余的输入之前再最后一次调用 stringDecoder.write()。
stringDecoder.write(buffer)
buffer <Buffer> | <TypedArray> | <DataView> 包含要解码的字节的 Buffer、 TypedArray 或 DataView。
返回: <string>
返回一个已解码的字符串,确保在返回的字符串不包含 Buffer、 TypedArray 或 DataView 末尾的任何不完整的多字节字符,并将其存储在内部缓冲区中,以便下次调用 stringDecoder.write() 或 stringDecoder.end()。