SharedArrayBuffer.prototype.slice()

構文

slice()
slice(start)
slice(start, end)

引数

start 省略可

取り出す範囲の先頭の 0 から始まるインデックスで、整数に変換されます。

• 負のインデックスを指定すると、バッファーの末尾から前にカウントします。 -buffer.length <= start < 0 の場合、 start + buffer.length が使用されます。
• start < -buffer.length または start が省略された場合、 0 が使用されます。
• start >= buffer.length の場合、空のバッファーが返されます。

end 省略可

取り出す範囲の末尾の 0 から始まるインデックスで、整数に変換されます。 slice() はここまでを取り出しますが、 end の位置は含めません。

• 負のインデックスを指定すると、バッファーの末尾から前にカウントします。 -buffer.length <= end < 0 の場合、 end + buffer.length が使用されます。
• end < -buffer.length の場合、 0 が使用されます。
• end >= buffer.length または end が省略されたか undefined の場合、 buffer.length が使用され、末尾までのすべての要素が抽出されます。
• end が start が示す位置の前またはその位置を意味する場合、空のバッファーが返されます。

返値

取り出した要素が入った新しい SharedArrayBuffer です。

例

これらの例は、コンソールや任意のウェブページから直接実行することはできません。SharedArrayBuffer は、そのセキュリティ要件が満たされない限り定義されないからです。

slice() の使用

// SharedArrayBuffer をバイト数でサイズを指定して作成
const buffer = new SharedArrayBuffer(16);
const int32View = new Int32Array(buffer);
int32View[1] = 42;
// Int32Array [0, 42, 0, 0] を産出

const sliced = new Int32Array(buffer.slice(4, 12));
console.log(sliced); // Int32Array [42, 0]

様々な開始値と終了値の使用

const sab = new SharedArrayBuffer(1024);
sab.slice(); // SharedArrayBuffer { byteLength: 1024 }
sab.slice(2); // SharedArrayBuffer { byteLength: 1022 }
sab.slice(-2); // SharedArrayBuffer { byteLength: 2 }
sab.slice(0, 1); // SharedArrayBuffer { byteLength: 1 }

仕様書

ブラウザーの互換性

関連情報

• SharedArrayBuffer
• ArrayBuffer.prototype.slice()