Node.js v25.0.0 文档
- Node.js v25.0.0
- 目录
-
索引
- 断言测试
- 异步上下文跟踪
- 异步钩子
- 缓冲区
- C++ 插件
- 使用 Node-API 的 C/C++ 插件
- C++ 嵌入器 API
- 子进程
- 集群
- 命令行选项
- 控制台
- 加密
- 调试器
- 已弃用的 API
- 诊断通道
- DNS
- 域
- 环境变量
- 错误
- 事件
- 文件系统
- 全局对象
- HTTP
- HTTP/2
- HTTPS
- 检查器
- 国际化
- 模块:CommonJS 模块
- 模块:ECMAScript 模块
- 模块:
node:module
API - 模块:包
- 模块:TypeScript
- 网络
- 操作系统
- 路径
- 性能钩子
- 权限
- 进程
- Punycode
- 查询字符串
- 逐行读取
- REPL
- 报告
- 单一可执行文件应用
- SQLite
- 流
- 字符串解码器
- 测试运行器
- 定时器
- TLS/SSL
- 跟踪事件
- TTY
- UDP/数据报
- URL
- 实用工具
- V8
- 虚拟机
- WASI
- Web Crypto API
- Web Streams API
- 工作线程
- Zlib
- 其他版本
- 选项
字符串解码器#
稳定性:2 - 稳定
node:string_decoder
模块提供了一个 API,用于将 Buffer
对象解码为字符串,并保留编码后的多字节 UTF-8 和 UTF-16 字符。可以使用以下方式访问它:
import { StringDecoder } from 'node:string_decoder';
const { StringDecoder } = require('node:string_decoder');
以下示例展示了 StringDecoder
类的基本用法。
import { StringDecoder } from 'node:string_decoder';
import { Buffer } from 'node:buffer';
const decoder = new StringDecoder('utf8');
const cent = Buffer.from([0xC2, 0xA2]);
console.log(decoder.write(cent)); // Prints: ¢
const euro = Buffer.from([0xE2, 0x82, 0xAC]);
console.log(decoder.write(euro)); // Prints: €
const { StringDecoder } = require('node:string_decoder');
const decoder = new StringDecoder('utf8');
const cent = Buffer.from([0xC2, 0xA2]);
console.log(decoder.write(cent)); // Prints: ¢
const euro = Buffer.from([0xE2, 0x82, 0xAC]);
console.log(decoder.write(euro)); // Prints: €
当一个 Buffer
实例被写入 StringDecoder
实例时,会使用一个内部缓冲区来确保解码后的字符串不包含任何不完整的多字节字符。这些字符会被保留在缓冲区中,直到下一次调用 stringDecoder.write()
或 stringDecoder.end()
。
在下面的示例中,欧元符号(€
)的三个 UTF-8 编码字节通过三个独立的操作写入:
import { StringDecoder } from 'node:string_decoder';
import { Buffer } from 'node:buffer';
const decoder = new StringDecoder('utf8');
decoder.write(Buffer.from([0xE2]));
decoder.write(Buffer.from([0x82]));
console.log(decoder.end(Buffer.from([0xAC]))); // Prints: €
const { StringDecoder } = require('node:string_decoder');
const decoder = new StringDecoder('utf8');
decoder.write(Buffer.from([0xE2]));
decoder.write(Buffer.from([0x82]));
console.log(decoder.end(Buffer.from([0xAC]))); // Prints: €
类: StringDecoder
#
new StringDecoder([encoding])
#
创建一个新的 StringDecoder
实例。
stringDecoder.end([buffer])
#
buffer
<string> | <Buffer> | <TypedArray> | <DataView> 要解码的字节。- 返回: <string>
将内部缓冲区中存储的任何剩余输入作为字符串返回。代表不完整 UTF-8 和 UTF-16 字符的字节将被替换为适合该字符编码的替换字符。
如果提供了 buffer
参数,在返回剩余输入之前,会最后再执行一次对 stringDecoder.write()
的调用。调用 end()
之后,stringDecoder
对象可以被重用于处理新的输入。
stringDecoder.write(buffer)
#
buffer
<string> | <Buffer> | <TypedArray> | <DataView> 要解码的字节。- 返回: <string>
返回一个解码后的字符串,并确保 Buffer
、TypedArray
或 DataView
末尾的任何不完整的多字节字符从返回的字符串中省略,并存储在内部缓冲区中,以供下一次调用 stringDecoder.write()
或 stringDecoder.end()
时使用。