Buffer.alloc(size[, fill[, encoding]])
Node.js FS模块方法速查
- size {Number}
- fill {Value} 默认:undefined
- encoding {String} 默认:utf8
分配一个 size 字节大小的新 Buffer。如果 fill 是 undefined ,该 Buffer 将被零填充(zero-filled)。+
```
const buf = Buffer.alloc(5);
console.log(buf);
//
```
size 必须小于等于 require('buffer').kMaxLength(在64位架构上 kMaxLength 的大小是 (2^31)-1)的值,否则将抛出一个 RangeError 的错误。如果 size 小于 0 将创建一个特定的 0 长度(zero-length )的 Buffer。
如果指定了 fill 参数,将通过调用 buf.fill(fill) 初始化当前 Buffer 的分配。
```
const buf = Buffer.alloc(5, 'a');
console.log(buf);
//
```
如果同时指定了 fill 和 encoding 参数,将通过调用 buf.fill(fill, encoding) 初始化当前 Buffer 的分配。例如:
```
const buf = Buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64');
console.log(buf);
//
```
调用 Buffer.alloc(size) 方法显然要比替代的 Buffer.allocUnsafe(size) 要慢,但可以确保新建的 Buffer 实例的内容不会包含敏感数据。
如果 size 不是一个数字则抛出一个 TypeError 错误。