このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

BigInt64Array() コンストラクター

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年9月以降、すべてのブラウザーで利用可能です。

BigInt64Array() コンストラクターは、新しい BigInt64Array オブジェクトを生成します。初期化データが明示的に指定されていない場合、内容は 0n に初期化されます。

構文

js
new BigInt64Array()
new BigInt64Array(length)
new BigInt64Array(typedArray)
new BigInt64Array(object)

new BigInt64Array(buffer)
new BigInt64Array(buffer, byteOffset)
new BigInt64Array(buffer, byteOffset, length)

メモ: BigInt64Array()new 付きでのみ構築できます。new なしで呼び出そうとすると、TypeError が発生します。

引数

TypedArrayを参照してください。

例外

TypedArrayを参照してください。

BigInt64Array を生成するための様々な方法

js
// 長さから
const bigint64 = new BigInt64Array(2);
bigint64[0] = 42n;
console.log(bigint64[0]); // 42n
console.log(bigint64.length); // 2
console.log(bigint64.BYTES_PER_ELEMENT); // 8

// 配列から
const x = new BigInt64Array([21n, 31n]);
console.log(x[1]); // 31n

// 他の TypedArray から
const y = new BigInt64Array(x);
console.log(y[0]); // 21n

// ArrayBuffer から
const buffer = new ArrayBuffer(64);
const z = new BigInt64Array(buffer, 8, 4);
console.log(z.byteOffset); // 8

// 反復可能オブジェクトから
const iterable = (function* () {
  yield* [1n, 2n, 3n];
})();
const bigint64FromIterable = new BigInt64Array(iterable);
console.log(bigint64FromIterable);
// BigInt64Array [1n, 2n, 3n]

仕様書

仕様書
ECMAScript® 2027 Language Specification
# sec-typedarray-constructors

ブラウザーの互換性

関連情報