HOWTO · Java

Java でバイト配列を整数に変換する

このチュートリアルでは、Java でバイト配列を int に変換する方法を示します

このページの内容

Java でバイト配列を整数に変換する処理は、ネットワークプロトコル、ファイル I/O、バイナリデータ形式を扱う場面でよく必要になります。適切な方法はバイト列が何を表しているかによって変わります。複数のバイトが 1 つの int をエンコードしている場合もあれば、各バイトが独立した値である場合もあります。この記事では、コア Java の方法である ByteBuffer、DataInputStream、手動のビットシフト、BigInteger に加えて、結果が正しいかどうかを決定するバイトオーダーと符号のルールを解説します。

ByteBuffer で 4 バイトを int に変換する

ByteBuffer(java.nio 内)は、この変換を行う最も直接的なコア Java のツールです。wrap メソッドは配列のストレージを共有するバッファを作成し、getInt() はバッファの現在位置から 4 バイトを読み取り、1 つの int として解釈します。次の例を実行してください。

このセクションのコードと表示されるラベルや出力は英語のままです。

import java.nio.ByteBuffer;

public class ByteArrayToInt {
  public static void main(String[] args) {
    byte[] byteArray = {0x00, 0x01, 0x03, 0x10};

    int intValue = ByteBuffer.wrap(byteArray).getInt();

    System.out.println("Converted Integer Value: " + intValue);
  }
}

出力:

Converted Integer Value: 66320

ByteBuffer は、すべてのプラットフォームでデフォルトがビッグエンディアンです。配列の先頭バイトが最上位バイトとして扱われます。データがリトルエンディアン順で書き込まれている場合は、読み取る前に ByteOrder でその順序を明示的に指定してください。

import java.nio.ByteBuffer;
import java.nio.ByteOrder;

public class ByteArrayToIntOrder {
  public static void main(String[] args) {
    byte[] byteArray = {0x00, 0x01, 0x03, 0x10};

    int bigEndianValue = ByteBuffer.wrap(byteArray).getInt();
    int littleEndianValue =
        ByteBuffer.wrap(byteArray).order(ByteOrder.LITTLE_ENDIAN).getInt();

    System.out.println("big-endian: " + bigEndianValue);
    System.out.println("little-endian: " + littleEndianValue);
  }
}

出力:

big-endian: 66320
little-endian: 268632320

ここでは 2 つの点が重要です。1 つ目は、getInt() がバッファの現在位置で読み取りを行い、位置を 4 つ進めることです。したがって、同じバッファで 2 回呼び出すと次の 4 バイトが読み取られます。新しい wrap は常に位置 0 から始まります。2 つ目は、残りのバイトが 4 つ未満の場合、getInt() が BufferUnderflowException をスローすることです。読み取る前に入力の長さを確認してください。

DataInputStream で 4 バイトを読み取る

バイトがストリーム経由で到着する場合や、複数のプリミティブ値を順番に読み取りたい場合には、DataInputStream が適しています。配列を ByteArrayInputStream でラップし、それをさらに DataInputStream でラップして、readInt() を呼び出します。

このセクションのコードと表示されるラベルや出力は英語のままです。

import java.io.ByteArrayInputStream;
import java.io.DataInputStream;
import java.io.IOException;

public class ByteArrayToIntWithDataInputStream {
  public static void main(String[] args) throws IOException {
    byte[] byteArray = {0x00, 0x01, 0x03, 0x10};

    try (DataInputStream input =
        new DataInputStream(new ByteArrayInputStream(byteArray))) {
      int intValue = input.readInt();
      System.out.println("Converted Integer Value: " + intValue);
    }
  }
}

出力:

Converted Integer Value: 66320

readInt() は、プラットフォームに関係なく、常に次の 4 バイトをビッグエンディアン順として解釈します。ストリーム内の残りバイトが 4 つ未満の場合は EOFException がスローされるため、これをキャッチすれば、クラッシュさせずに入力が短いことを報告できます。

import java.io.ByteArrayInputStream;
import java.io.DataInputStream;
import java.io.EOFException;
import java.io.IOException;

public class ByteArrayToIntShortInput {
  public static void main(String[] args) throws IOException {
    byte[] byteArray = {0x03, 0x10};

    try (DataInputStream input =
        new DataInputStream(new ByteArrayInputStream(byteArray))) {
      int intValue = input.readInt();
      System.out.println("Converted Integer Value: " + intValue);
    } catch (EOFException e) {
      System.out.println("readInt() needs four bytes, but only " + byteArray.length + " remain");
    }
  }
}

出力:

readInt() needs four bytes, but only 2 remain

バイトをシフトして int を組み立てる

バイトを自分でシフトすると、変換がどのように機能するかが正確にわかり、順序と長さを完全に制御できます。各バイトについて、累積値を 8 ビット左にシフトし、次のバイトを OR で結合します。

このセクションのコードと表示されるラベルや出力は英語のままです。

public class ByteArrayToIntManually {
  public static void main(String[] args) {
    byte[] byteArray = {0x00, 0x01, 0x03, 0x10};

    int intValue = 0;

    for (byte b : byteArray) {
      intValue = (intValue << 8) | (b & 0xFF);
    }

    System.out.println("Converted Integer Value: " + intValue);
  }
}

出力:

Converted Integer Value: 66320

Java の byte 型は符号付きで、0x80 は -128 として格納されるため、b & 0xFF のマスクが必要です。マスクがなければ、| は 0x00000080 ではなく 0xFFFFFF80 を結合してしまい、上位のすべてのバイトが破壊されます。このループは、配列の先頭要素を最上位バイトとするビッグエンディアン順でバイトを組み立て、配列がちょうど 4 バイトを保持していることを前提としています。順序を変える場合は配列を逆方向に反復し、バイト数が多い場合は int ではなく long に累積してください。

BigInteger でバイト配列を解釈する

BigInteger はコンストラクタでバイト配列を直接受け取り、それを任意長の符号付き・ビッグエンディアン・2 の補数の数値として解釈します。その後、intValue() で結果を int に縮小します。

このセクションのコードと表示されるラベルや出力は英語のままです。

import java.math.BigInteger;

public class ByteArrayToIntWithBigInteger {
  public static void main(String[] args) {
    byte[] byteArray = {0x00, 0x01, 0x03, 0x10};

    int intValue = new BigInteger(byteArray).intValue();

    System.out.println("Converted Integer Value: " + intValue);
  }
}

出力:

Converted Integer Value: 66320

解釈は符号付きなので、先頭の 1 ビットは 0 未満の値を生成します。符号なしの解釈にするには、コンストラクタの最初の引数に符号値 1 を渡してください。intValue() は下位 32 ビットのみを保持することに注意してください。int に収まらない値は警告なしに切り捨てられます。

import java.math.BigInteger;

public class BigIntegerSignAndRange {
  public static void main(String[] args) {
    byte[] allOnes = {(byte) 0xFF, (byte) 0xFF, (byte) 0xFF, (byte) 0xFF};

    System.out.println("signed: " + new BigInteger(allOnes));
    System.out.println("unsigned: " + new BigInteger(1, allOnes));
    System.out.println("narrowed to int: " + new BigInteger(1, allOnes).intValue());
  }
}

出力:

signed: -1
unsigned: 4294967295
narrowed to int: -1

BigInteger は、配列が 4 バイトより長い場合や、縮小する前に符号なしの大きさが必要な場合に自然な選択肢です。

各バイトを個別に変換する

上記の方法はすべて、複数のバイトを 1 つの数値にまとめます。各バイトがセンサーの読み取り値、カラーチャンネル、プロトコルフィールドなどの独立した値である場合は、代わりに各要素を個別に変換してください。区別に注意してください。2 バイトに対する getShort() や readShort() は 1 つに結合された short を生成するものであり、各バイトを個別に変換するものではありません。

また、Java の byte 型は -128 から 127 の範囲の符号付きであることも覚えておいてください。0 から 255 の符号なしの値を意図する場合は、Byte.toUnsignedInt(Java 8 以降で利用可能)または同等の b & 0xFF マスクを使用します。

このセクションのコードと表示されるラベルや出力は英語のままです。

public class PrintEachByte {
  public static void main(String[] args) {
    byte[] byteArray = {0x03, 0x04, (byte) 0x80, (byte) 0xFF};

    for (byte b : byteArray) {
      System.out.println("signed: " + b + " unsigned: " + Byte.toUnsignedInt(b));
    }
  }
}

出力:

signed: 3 unsigned: 3
signed: 4 unsigned: 4
signed: -128 unsigned: 128
signed: -1 unsigned: 255

方法の選択とエッジケースへの対処

それぞれのアプローチは異なる状況に適しています。

  • ByteBuffer は、配列から 4 バイトの int を読み取る際の第一候補です。コンパクトで、ByteOrder を通じて両方のバイトオーダーをサポートし、他の幅には getLong()、getShort() などを提供します。
  • DataInputStream は、すでにストリームを扱っていて、複数の型付き値を順番に読み取る必要があるコードに適しています。その読み取りは常にビッグエンディアンです。
  • 手動シフトは数行多くかかりますが、順序、オフセット、幅を正確に制御でき、バッファやストリームオブジェクトを必要としません。
  • BigInteger は、4 バイトより長い配列や、縮小前に明示的な符号付きまたは符号なしの解釈が必要な場合に対応します。
  • Byte.toUnsignedInt によるバイトごとの変換は、すべての要素が 1 つの数値の一部ではなく、それぞれ独自の値である場合に適用されます。

どの方法を選ぶ場合でも、変換前に次の点を確認してください。

  • 入力の長さ: より短い配列に対する 4 バイトの読み取りは失敗します。ByteBuffer では BufferUnderflowException、DataInputStream では EOFException が発生し、手動コードでは ArrayIndexOutOfBoundsException または警告なしの誤った結果になります。
  • バイトオーダー: 読み取り側の順序は、バイトが書き込まれた順序と一致する必要があります。ByteBuffer はデフォルトでビッグエンディアンで、ByteOrder で切り替えられます。一方、DataInputStream の読み取りは常にビッグエンディアンで、順序の選択肢はありません。
  • 符号と範囲: getInt() と readInt() は符号付きの int を返すため、Integer.MAX_VALUE を超える符号なし 32 ビット値は 0 未満として表示されます。ソースデータが符号なしの場合は、Integer.toUnsignedLong(intValue) を使用するか、long に累積してください。
  • バッファ位置: ByteBuffer を再利用すると、先頭ではなく現在位置から続行されます。配列を再読み取りするには rewind() を呼び出すか、再度 wrap してください。