Uint8ClampedArray

Uint8ClampedArray 型の配列は、0-255 の範囲に切り詰められた8ビットの符号なし整数の配列を表し、[0,255] の範囲外の値を指定した場合は、代わりに 0 または 255 が設定されます。内容は 0 に初期化されます。一度確立されると、オブジェクトのメソッドを使用して配列内の要素を参照するか、標準の配列インデックス構文を使用して（つまり、角括弧表記を使用して）配列を参照することができます。

コンストラクタ

Uint8ClampedArray()

新しい Uint8ClampedArray() オブジェクトを作成します。

静的プロパティ

Uint8ClampedArray.BYTES_PER_ELEMENT

要素のサイズを数値で返します。Uint8ClampedArray() の場合は 1 です。

Uint8ClampedArray.name

コンストラクタ名の文字列を返します。Uint8ClampedArray() は "Uint8ClampedArray" です。

静的メソッド

Uint8ClampedArray.from()

array-like、あるいは iterable オブジェクトから新しい Uint8ClampedArray を作成します。Array.from() も参照してください。

Uint8ClampedArray.of()

可変数の引数から新しい Uint8ClampedArray を作成します。Array.of() も参照してください。

インスタンスのプロパティ

Uint8ClampedArray.prototype.buffer

Uint8ClampedArray が参照する ArrayBuffer を返します。これは構築時に固定されているため、読み取り専用です

Uint8ClampedArray.prototype.byteLength

Uint8ClampedArray の ArrayBuffer の先頭からの長さをバイト数で返します。これは構築時に固定されているため、読み取り専用です。

Uint8ClampedArray.prototype.byteOffset

Uint8ClampedArray の ArrayBuffer の先頭からのオフセットをバイト単位で返します。これは構築時に固定されているため、読み取り専用です。

Uint8ClampedArray.prototype.length

Uint8ClampedArray に保持されている要素数を返します。これは構築時に固定されているため、読み取り専用です。

インスタンスのメソッド

Uint8ClampedArray.prototype.copyWithin()

配列内の配列要素のシーケンスをコピーします。Array.prototype.copyWithin() も参照してください。

Uint8ClampedArray.prototype.entries()

配列の各インデックスのキーと値のペアを含む、新しい Array Iterator オブジェクトを返します。Array.prototype.entry() も参照してください。

Uint8ClampedArray.prototype.every()

配列のすべての要素が、関数で指定されたテストに合格するかどうかをテストします。Array.prototype.every() も参照してください。

Uint8ClampedArray.prototype.fill()

開始インデックスから終了インデックスまでの、配列のすべての要素を静的な値で埋めます。Array.prototype.fill() も参照してください。

Uint8ClampedArray.prototype.filter()

指定したフィルタリング関数が true を返す要素をすべて含む、新しい配列を作成します。Array.prototype.filter() も参照してください。

Uint8ClampedArray.prototype.find()

配列内の要素が指定したテスト関数を満たしている場合は、配列内で見つかった値を返し、見つからなかった場合は undefined を返します。Array.prototype.find() も参照してください。

Uint8ClampedArray.prototype.findIndex()

配列内の要素が指定したテスト関数を満たす場合は、配列内で見つかったインデックスを返し、見つからなかった場合は -1 を返します。Array.prototype.findIndex() も参照してください。

Uint8ClampedArray.prototype.forEach()

配列の各要素に対して関数を呼び出します。Array.prototype.forEach() も参照してください。

Uint8ClampedArray.prototype.includes()

型付き配列が特定の要素を含むかどうかを判断し、適切な場合は true または false を返します。Array.prototype.includes() も参照してください。

Uint8ClampedArray.prototype.indexOf()

指定した値と等しい配列内の要素の最初の（最小の）インデックスを返します。何も見つからない場合は -1 を返します。Array.prototype.indexOf() も参照してください。

Uint8ClampedArray.prototype.join()

配列のすべての要素を文字列に結合します。Array.prototype.join() も参照してください。

Uint8ClampedArray.prototype.keys()

配列の各インデックスのキーを含む新しい Array Iterator を返します。Array.prototype.keys() も参照してください。

Uint8ClampedArray.prototype.lastIndexOf()

指定した値と等しい配列内の要素の最後の（最大の）インデックスを返します。何も見つからない場合は -1 を返します。Array.prototype.lastIndexOf() も参照してください。

Uint8ClampedArray.prototype.map()

この配列の各要素に対して指定した関数を呼び出した結果を持つ、新しい配列を作成します。Array.prototype.map() も参照してください。

Uint8ClampedArray.prototype.reduce()

アキュムレータと配列の各値（左から右へ）を一つの値に減らすための関数を適用します。Array.prototype.reduce() も参照してください。

Uint8ClampedArray.prototype.reduceRight()

アキュムレータと配列の各値（右から左へ）を一つの値に減らすための関数を適用します。Array.prototype.reduceRight() も参照してください。

Uint8ClampedArray.prototype.reverse()

配列の要素の順序を反転させます — 最初が最後になり、最後が最初になります。Array.prototype.reverse() も参照してください。

Uint8ClampedArray.prototype.set()

型付けされた配列に複数の値を格納し、指定した配列から入力値を読み込みます。

Uint8ClampedArray.prototype.slice()

配列の一部を抽出し、新しい配列を返します。Array.prototype.slice() も参照してください。

Uint8ClampedArray.prototype.some()

配列の少なくとも一つの要素が、指定したテスト関数を満たしている場合に true を返します。Array.prototype.some() も参照してください。

Uint8ClampedArray.prototype.sort()

配列の要素を所定の位置に並べ替えて、その配列を返します。Array.prototype.sort() も参照してください。

Uint8ClampedArray.prototype.subarray()

指定した開始要素と終了要素のインデックスから、新しい Uint8ClampedArray を返します。

Uint8ClampedArray.prototype.values()

配列の各インデックスの値を含む、新しい Array Iterator オブジェクトを返します。Array.prototype.values() も参照してください。

Uint8ClampedArray.prototype.toLocaleString()

配列とその要素を表すローカライズされた文字列を返します。Array.prototype.toLocaleString() も参照してください。

Uint8ClampedArray.prototype.toString()

配列とその要素を表す文字列を返します。Array.prototype.toString() も参照してください。

Uint8ClampedArray.prototype[@@iterator]()

配列の各インデックスの値を含む、新しい Array Iterator オブジェクトを返します。

例

Uint8ClampedArray の作成方法の違い

// length から
var uintc8 = new Uint8ClampedArray(2);
uintc8[0] = 42;
uintc8[1] = 1337;
console.log(uintc8[0]); // 42
console.log(uintc8[1]); // 255 (clamped)
console.log(uintc8.length); // 2
console.log(uintc8.BYTES_PER_ELEMENT); // 1

// 配列から
var arr = new Uint8ClampedArray([21,31]);
console.log(arr[1]); // 31

// 別の TypedArray から
var x = new Uint8ClampedArray([21, 31]);
var y = new Uint8ClampedArray(x);
console.log(y[0]); // 21

// ArrayBuffer から
var buffer = new ArrayBuffer(8);
var z = new Uint8ClampedArray(buffer, 1, 4);

// iterable なものから
var iterable = function*(){ yield* [1,2,3]; }(); 
var uintc8 = new Uint8ClampedArray(iterable); 
// Uint8ClampedArray[1, 2, 3]

仕様書

ブラウザの互換性

See also

• JavaScript typed arrays
• ArrayBuffer
• DataView