C#のBuffer.SetByteメソッドの使い方とサンプルコード

Buffer.SetByte()メソッドは、指定した配列内の特定の場所（バイトオフセット）に、指定した値を1バイトとして設定するためのメソッドです。配列をバイト単位で直接操作したい場合に便利です。

基本的な使い方

まず、操作対象となる配列を用意します。

int[] arr = { 3, 4, 12 };

次に、SetByte()を使って指定位置に値を書き込みます。

Buffer.SetByte(arr, 3, 20);

この例では、配列の先頭から3バイト目（インデックス3）に「20」という値を設定しています。

サンプルコード

以下は、Buffer.SetByte()を使った完全なサンプルプログラムです。

using System;
using System.Text;

public class Demo {
   public static void Main() {
      int[] arr = { 3, 4, 12 };
      Console.WriteLine("Initial Array...");
      // バイト配列としてループ処理
      for (int i = 0; i < Buffer.ByteLength(arr); i++) {
         Console.WriteLine(Buffer.GetByte(arr, i));
      }
      Buffer.SetByte(arr, 3, 20);
      Console.WriteLine("New Array...");
      // 変更後のバイト配列をループ処理
      for (int i = 0; i < Buffer.ByteLength(arr); i++) {
         Console.WriteLine(Buffer.GetByte(arr, i));
      }
   }
}

実行結果

Initial Array...
3
0
0
0
4
0
0
0
12
0
0
0
New Array...
3
0
0
20
4
0
0
0
12
0
0
0

解説

この実行結果から、int型は1要素あたり4バイトで構成されていることがわかります。初期状態では、各要素の値（3・4・12）がそれぞれ先頭バイトに格納され、残りの3バイトは0になっています。

その後、Buffer.SetByte(arr, 3, 20)を実行することで、配列全体を連続したバイト列とみなしたときの3バイト目（つまり最初の要素「3」を構成する2番目のバイト）が「20」に書き換えられていることが確認できます。

なお、読み取りにはBuffer.GetByte()、配列全体のバイト数の取得にはBuffer.ByteLength()を使用しており、これらを組み合わせることで、プリミティブ型の配列をバイトレベルで柔軟に操作できます。