ArrayBuffer.transfer()

概要

静的なArrayBuffer.transfer() メソッドは、oldBufferのデータから得られる内容の新しいArrayBufferを返します。newByteLengthによって切断されるかゼロ拡張されます。newByteLengthがundefinedなら、oldBufferのbyteLengthが使われます。この操作は切り離された状態でoldBufferを見捨てます。

構文

ArrayBuffer.transfer(oldBuffer [, newByteLength]);

引数

oldBuffer

転送するためのArrayBufferオブジェクト

newByteLength

新しいArrayBufferオブジェクトのバイト長

説明

ArrayBuffer.transfer() メソッドによって、ArrayBufferオブジェクトを成長し、デタッチできます。コピーなしでArrayBufferを成長される能力は大規模バッファに対してもっと早くなる利点を持っています。ArrayBufferをデタッチする能力は根本的にメモリがリリースされるときを開発者が明示的に制御することができます。これにより、すべての参照を削除し、ガベージコレクションを待つことを避けます。

例

var buf1 = new ArrayBuffer(40);
new Int32Array(buf1)[0] = 42;

var buf2 = ArrayBuffer.transfer(buf1, 80);
buf1.byteLength; // 0
buf2.byteLength; // 80
new Int32Array(buf2)[0]; // 42

var buf3 = ArrayBuffer.transfer(buf2, 0);
buf2.byteLength; // 0
buf3.byteLength; // 0

仕様

すべての現在の仕様のドラフトではサポートされていません。しかし、ES7に対して提案されています。

ブラウザ実装状況

関連情報

• JavaScript typed arrays