MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

TypedArray.prototype.subarray()

この翻訳は不完全です。英語から この記事を翻訳 してください。

概要

同じArrayBufferストアで、TypedArrayオブジェクトと同じ要素の型をもつ新しいTypedArrayを返します。beginオフセットは包括して、endオフセットは排他的です。 TypedArraytyped array typesの一つです。

構文

typedarray.subarray([begin [,end]])

引数

begin Optional
初めの要素。オフセットは、含まれます。
end Optional
最後の要素。オフセットは、含まれません。指定されなかったら、beginによって指定された要素から配列の最後まですべての要素が新しいビューに含まれます。

説明

beginendによって指定される範囲は、現在の配列に対して有効なインデックスの範囲に縮められます。すなわち、新しい範囲の計算された長さがマイナスなら、ゼロに縮められます。beginendのどちらかがマイナスなら、配列の最初からではなく、最後からインデックスを参照します。

既存のバッファ上に新しいビューを作っていることにも注意して下さい。すなわち、新しいオブジェクトの内容への変更は、元のオブジェクトに強い影響を与えます。逆もまた同様です。

subarray メソッドを使う

var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);
uint8.set([1,2,3]);

console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]

var sub = uint8.subarray(0,4);

console.log(sub);   // Uint8Array [ 1, 2, 3, 0 ]

仕様

仕様 状況 コメント
Typed Array Specification Obsolete ECMAScript第6版で置き換えられました。
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'TypedArray.prototype.subarray' in that specification.
Standard ECMA仕様で初期定義。

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 7.0 4.0 (2) 10 11.6 5.1
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート 4.0 (有) 4.0 (2) 10 11.6 4.2

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: shide55
 最終更新者: shide55,