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

View in English Always switch to English

DataView.prototype.setInt8()

Baseline 広く利用可能

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

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

試してみましょう

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

const view = new DataView(buffer);
view.setInt8(1, 127); // 符号付き 8 ビット整数の最大値

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

構文

js
setInt8(byteOffset, value)

引数

byteOffset

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

value

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

返値

undefined です。

発生するエラー

RangeError

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

setInt8() の使用

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

仕様書

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

ブラウザーの互換性

関連情報