buf.slice([start[, end]])

版本历史

版本	变更
v17.5.0	buf.slice() 方法已被弃用。
v7.0.0	在进行任何计算之前，所有偏移量现在都被强制为整数。
v7.1.0, v6.9.2	将偏移量强制为整数现在可以正确处理 32 位整数范围之外的值。
v0.3.0	新增于: v0.3.0

start <integer> 新的 Buffer 将开始的位置。 默认值: 0。
end <integer> 新的 Buffer 将结束的位置（不包括在内）。 默认值: buf.length.
返回: <Buffer>

稳定性: 0 - 弃用: 改为使用 buf.subarray 。

返回新的 Buffer，其引用与原始缓冲区相同的内存，但由 start 和 end 索引进行偏移和裁剪。

此方法与 Uint8Array.prototype.slice()（Buffer 的超类）不兼容。要复制切片，则使用 Uint8Array.prototype.slice()。

import { Buffer } from 'node:buffer';

const buf = Buffer.from('buffer');

const copiedBuf = Uint8Array.prototype.slice.call(buf);
copiedBuf[0]++;
console.log(copiedBuf.toString());
// 打印: cuffer

console.log(buf.toString());
// 打印: buffer

// 使用 buf.slice()，修改原始的缓冲区。
const notReallyCopiedBuf = buf.slice();
notReallyCopiedBuf[0]++;
console.log(notReallyCopiedBuf.toString());
// 打印: cuffer
console.log(buf.toString());
// 也打印: cuffer (!)const { Buffer } = require('node:buffer');

const buf = Buffer.from('buffer');

const copiedBuf = Uint8Array.prototype.slice.call(buf);
copiedBuf[0]++;
console.log(copiedBuf.toString());
// 打印: cuffer

console.log(buf.toString());
// 打印: buffer

// 使用 buf.slice()，修改原始的缓冲区。
const notReallyCopiedBuf = buf.slice();
notReallyCopiedBuf[0]++;
console.log(notReallyCopiedBuf.toString());
// 打印: cuffer
console.log(buf.toString());
// 也打印: cuffer (!)

History

Version	Changes
v17.5.0	The buf.slice() method has been deprecated.
v7.0.0	All offsets are now coerced to integers before doing any calculations with them.
v7.1.0, v6.9.2	Coercing the offsets to integers now handles values outside the 32-bit integer range properly.
v0.3.0	Added in: v0.3.0

start <integer> Where the new Buffer will start. Default: 0.
end <integer> Where the new Buffer will end (not inclusive). Default: buf.length.
Returns: <Buffer>

Stability: 0 - Deprecated: Use buf.subarray instead.

Returns a new Buffer that references the same memory as the original, but offset and cropped by the start and end indices.

This method is not compatible with the Uint8Array.prototype.slice(), which is a superclass of Buffer. To copy the slice, use Uint8Array.prototype.slice().

import { Buffer } from 'node:buffer';

const buf = Buffer.from('buffer');

const copiedBuf = Uint8Array.prototype.slice.call(buf);
copiedBuf[0]++;
console.log(copiedBuf.toString());
// Prints: cuffer

console.log(buf.toString());
// Prints: buffer

// With buf.slice(), the original buffer is modified.
const notReallyCopiedBuf = buf.slice();
notReallyCopiedBuf[0]++;
console.log(notReallyCopiedBuf.toString());
// Prints: cuffer
console.log(buf.toString());
// Also prints: cuffer (!)const { Buffer } = require('node:buffer');

const buf = Buffer.from('buffer');

const copiedBuf = Uint8Array.prototype.slice.call(buf);
copiedBuf[0]++;
console.log(copiedBuf.toString());
// Prints: cuffer

console.log(buf.toString());
// Prints: buffer

// With buf.slice(), the original buffer is modified.
const notReallyCopiedBuf = buf.slice();
notReallyCopiedBuf[0]++;
console.log(notReallyCopiedBuf.toString());
// Prints: cuffer
console.log(buf.toString());
// Also prints: cuffer (!)