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

View in English Always switch to English

DataView.prototype.setUint8()

Baseline 広く利用可能

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

setUint8()DataView インスタンスのメソッドで、数値を受け取り、符号なし 8 ビット整数として、この DataView の指定されたバイトオフセットにあるバイトに格納します。

試してみましょう

// ArrayBuffer をバイト単位のサイズで作成
const buffer = new ArrayBuffer(16);

const view = new DataView(buffer);
view.setUint8(1, 255); // 符号なし 8 ビット整数の最大値

console.log(view.getUint8(1));
// 予想される結果: 255

構文

js
setUint8(byteOffset, value)

引数

byteOffset

データを格納するビューの先頭からのバイト単位のオフセットです。

value

設定する値。値がどのようにバイト列にエンコードされるかについては、値のエンコード方式と正規化を参照してください。

返値

undefined です。

発生するエラー

RangeError

byteOffset がビューの末尾を越えて格納するように設定されたときに発生します。

setUint8() の使用

js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setUint8(0, 3);
dataview.getUint8(0); // 3

仕様書

仕様書
ECMAScript® 2027 Language Specification
# sec-dataview.prototype.setuint8

ブラウザーの互換性

関連情報