Float32Array() コンストラクター
Float32Array()
は型付き配列のコンストラクターで、新しい Float32Array
オブジェクト、すなわち 32 ビット浮動小数点数 (C 言語の float
データ型に相当) の配列をプラットフォームのバイトオーダーで生成します。バイトオーダーを制御する必要がある場合は、代わりに DataView
を使用してください。生成後は、オブジェクトのメソッドや、標準の配列の添字構文 (すなわち角括弧表記) を用いて配列の要素を参照することができます。
構文
new Float32Array(); // new in ES2017 new Float32Array(length); new Float32Array(typedArray); new Float32Array(object); new Float32Array(buffer [, byteOffset [, length]]);
引数
length
-
length
引数付きで呼び出された場合、length
をBYTES_PER_ELEMENT
バイトで掛けた大きさで、内部の配列バッファーがメモリ内に生成され、内容がゼロになります。 typedArray
-
typedArray
引数は任意の型付き配列 (Int32Array
など) で、typedArray
を付けて呼び出された場合、その内容が新しい型付き配列に複写されます。typedArray
に含まれるそれぞれの値は、新しい配列にコピーされる前に、このコンストラクターに対応する型に変換されます。新しい型付き配列の長さは、typedArray
引数の長さと同じになります。 object
-
object
引数付きで呼び出された場合、新しい型付き配列はTypedArray.from()
メソッドのようにして生成されます。 buffer
,byteOffset
,length
-
buffer
引数と、任意でbyteOffset
およびlength
引数をつけて呼び出された場合、新しい型付き配列のビューが作成され、そのビューが指定されたArrayBuffer
となります。byteOffset
およびlength
引数は、型付き配列のビューで公開するメモリの範囲を指定します。両方が省略された場合は、buffer
全体がビューとなり、length
のみが省略された場合は、buffer
の残りがビューとなります。
例
Float32Array を生成するための様々な方法
js
// From a length
var float32 = new Float32Array(2);
float32[0] = 42;
console.log(float32[0]); // 42
console.log(float32.length); // 2
console.log(float32.BYTES_PER_ELEMENT); // 8
// From an array
var arr = new Float32Array([21, 31]);
console.log(arr[1]); // 31
// From another TypedArray
var x = new Float32Array([21, 31]);
var y = new Float32Array(x);
console.log(y[0]); // 21
// From an ArrayBuffer
var buffer = new ArrayBuffer(32);
var z = new Float32Array(buffer, 0, 4);
// From an iterable
var iterable = (function* () {
yield* [1, 2, 3];
})();
var float32 = new Float32Array(iterable);
// Float32Array[1, 2, 3]
仕様書
Specification |
---|
ECMAScript Language Specification # sec-typedarray-constructors |
ブラウザーの互換性
BCD tables only load in the browser