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 錯誤。