1
0
mirror of https://github.com/ruanyf/es6tutorial.git synced 2025-05-24 18:32:22 +00:00

docs(arrayBuffer): 更新 ArrayBuffer/字符串 相互转换函数,支持多语言及多编码

1. 原方法对于非 Unicode BMP 基本平面字符支持不理想。改为使用实验性 TextEncoder/TextDecoder 接口实现。
2. 浏览器支持列表见函数备注
3. Node.js v8.3 开始在 util 对象下实现接口,v11 开始提供全局接口
4. 函数名使用 ab (而非 buf)代表 ArrayBuffer ,避免与 Node.js 的 Buffer (Uint8Array的一个扩展)混淆
5. 虽然是 ECMA js 文档,考虑到 TypeScript 日益壮大,并且函数签名更利于文档规范化,故以带有类型的 TypeScript 代码展示
This commit is contained in:
waiting 2019-05-22 20:53:54 +08:00
parent dd69d69cc4
commit b9349b144d
No known key found for this signature in database
GPG Key ID: 9DC706A8664B0312

View File

@ -448,34 +448,40 @@ Float64Array.BYTES_PER_ELEMENT // 8
### ArrayBuffer 与字符串的互相转换
`ArrayBuffer`转为字符串,或者字符串转为`ArrayBuffer`,有一个前提,即字符串的编码方法是确定的。假定字符串采用 UTF-16 编码JavaScript 的内部编码方式),可以自己编写转换函数。
`ArrayBuffer` 和字符串相互转换, 使用原生 `TextEncoder` `TextDecoder` 类方法转换任何字符集字符串
outputEncoding 输出编码一般保持默认值utf-8可选值见文档
- https://encoding.spec.whatwg.org
- https://nodejs.org/api/util.html#util_whatwg_supported_encodings
```javascript
// ArrayBuffer 转为字符串,参数为 ArrayBuffer 对象
function ab2str(buf) {
// 注意,如果是大型二进制数组,为了避免溢出,
// 必须一个一个字符地转
if (buf && buf.byteLength < 1024) {
return String.fromCharCode.apply(null, new Uint16Array(buf));
}
const bufView = new Uint16Array(buf);
const len = bufView.length;
const bstr = new Array(len);
for (let i = 0; i < len; i++) {
bstr[i] = String.fromCharCode.call(null, bufView[i]);
}
return bstr.join('');
```ts
/**
* Convert ArrayBuffer/TypedArray to String via TextDecoder
*
* @see https://developer.mozilla.org/en-US/docs/Web/API/TextDecoder
*/
function ab2str(
input: ArrayBuffer | Uint8Array | Int8Array | Uint16Array | Int16Array | Uint32Array | Int32Array,
outputEncoding: string = 'utf8',
): string {
const decoder = new TextDecoder(outputEncoding)
return decoder.decode(input)
}
// 字符串转为 ArrayBuffer 对象,参数为字符串
function str2ab(str) {
const buf = new ArrayBuffer(str.length * 2); // 每个字符占用2个字节
const bufView = new Uint16Array(buf);
for (let i = 0, strLen = str.length; i < strLen; i++) {
bufView[i] = str.charCodeAt(i);
}
return buf;
/**
* Convert String to ArrayBuffer via TextEncoder
*
* @see https://developer.mozilla.org/zh-CN/docs/Web/API/TextEncoder
*/
function str2ab(input: string): ArrayBuffer {
const view = str2Uint8Array(input)
return view.buffer
}
/** Convert String to Uint8Array */
function str2Uint8Array(input: string): Uint8Array {
const encoder = new TextEncoder()
const view = encoder.encode(input)
return view
}
```