閉じる

JavaでStringをintに変換する方法｜Integer.parseIntの使い方と例外処理

広告

Javaプログラミングにおいて、文字列（String）を数値（int）に変換する処理は非常に頻繁に発生します。

ユーザーインターフェースからの入力値や、外部ファイル、APIから取得したデータは、その多くが文字列型として扱われるためです。

これらのデータを計算や比較に利用するためには、適切な数値型に変換する手順が欠かせません。

本記事では、Javaの標準的な変換手法である「Integer.parseInt」を中心に、その正しい使い方や注意点、例外処理の実装方法について詳しく解説します。

初心者から実務レベルまで役立つ知識を整理して紹介しますので、ぜひ参考にしてください。

目次 [ close ]
  1. Integer.parseIntの基本的な使い方
  2. Integer.parseIntとInteger.valueOfの違い
  3. 変換時に発生する例外と対処法
    1. NumberFormatExceptionが発生する主なケース
    2. try-catch文による安全な変換
  4. 進数を指定した変換方法
  5. 実践的なバリデーション手法
  6. null値への配慮とOptionalの活用
  7. まとめ

Integer.parseIntの基本的な使い方

Javaで文字列をint型に変換する最も一般的な方法は、java.lang.Integerクラスに用意されているparseIntメソッドを使用することです。

このメソッドは静的メソッド（static method）として定義されているため、インスタンス化せずに直接呼び出すことが可能です。

基本的な構文は、int 変数名 = Integer.parseInt(変換したい文字列);となります。

具体的なコード例を見てみましょう。

Java
public class Main {
    public static void main(String[] args) {
        // 文字列の定義
        String numberString = "123";

        // Integer.parseIntを使用して変換
        int result = Integer.parseInt(numberString);

        // 結果の出力
        System.out.println("変換後の数値: " + result);
        System.out.println("2倍にした値: " + (result * 2));
    }
}
実行結果
変換後の数値: 123
2倍にした値: 246

このように、数値として解釈可能な文字列を渡すことで、プリミティブ型のintを簡単に取得できます。

取得した値はそのまま算術演算に使用できるため、計算処理が必要なプログラムでは必須のテクニックです。

Integer.parseIntとInteger.valueOfの違い

JavaにはparseIntとよく似たメソッドとして、Integer.valueOfが存在します。

どちらも文字列を数値に変換する役割を持ちますが、戻り値の型が異なるという重要な違いがあります。

Integer.parseIntはプリミティブ型のintを返しますが、Integer.valueOfはラッパークラスであるIntegerオブジェクトを返します。

以下の表で、それぞれの違いを確認してみましょう。

メソッド名戻り値の型主な用途
Integer.parseInt(String)int (プリミティブ)計算や配列のインデックスなど、基本的な数値処理
Integer.valueOf(String)Integer (オブジェクト)ListやMapなどのコレクションに格納する場合

Javaのオートボクシング機能により、現代のプログラミングではこれらを厳密に使い分けなくても動作することが多いです。

しかし、メモリ効率やパフォーマンスを重視する場合は、不要なオブジェクト生成を避けるためにparseIntを選択するのが賢明です。

また、Integer.valueOfは内部でキャッシュを利用しているため、特定の範囲の数値（通常-128から127）であれば同じインスタンスを再利用するという特徴も持っています。

変換時に発生する例外と対処法

文字列を数値に変換する際には、常にエラーのリスクが伴います。

引数として渡された文字列が数値として解析できない場合、JavaはNumberFormatExceptionという例外をスローします。

この例外を適切にハンドリングしなければ、プログラムは強制終了してしまいます。

NumberFormatExceptionが発生する主なケース

例外が発生する代表的なケースとしては、以下のようなものが挙げられます。

  • 文字列の中に全角数字が含まれている場合
  • 数字以外の文字（アルファベットや記号）が含まれている場合
  • 空文字（””）や空白を含む文字列を渡した場合
  • nullを渡した場合（この場合はNullPointerExceptionが発生することもあります）
  • int型の範囲（-2,147,483,648 ～ 2,147,483,647）を超える数値を指定した場合

try-catch文による安全な変換

実務的なアプリケーションでは、ユーザーがどのような値を入力するか予測できません。

そのため、変換処理を行う際は必ずtry-catchブロックを使用して、エラー時の挙動を定義しておく必要があります。

Java
public class SafeParse {
    public static void main(String[] args) {
        String input = "abc"; // 数値ではない文字列

        try {
            int value = Integer.parseInt(input);
            System.out.println("数値: " + value);
        } catch (NumberFormatException e) {
            System.out.println("エラー: 入力された文字列は数値ではありません。");
        }
    }
}
実行結果
エラー: 入力された文字列は数値ではありません。

このように例外処理を記述することで、不適切な入力があった場合でもシステム全体を停止させずに、ユーザーへの警告メッセージ表示などを継続できます。

進数を指定した変換方法

Integer.parseIntには、第二引数に「基数（radix）」を指定できるオーバーロードメソッドが存在します。

これを利用することで、2進数、8進数、16進数などの文字列を10進数のint型に変換することが可能です。

Java
public class RadixExample {
    public static void main(String[] args) {
        // 16進数の文字列を変換
        String hex = "FF";
        int hexValue = Integer.parseInt(hex, 16);
        System.out.println("16進数 FF の10進数: " + hexValue);

        // 2進数の文字列を変換
        String binary = "1010";
        int binValue = Integer.parseInt(binary, 2);
        System.out.println("2進数 1010 の10進数: " + binValue);
    }
}
実行結果
16進数 FF の10進数: 255
2進数 1010 の10進数: 10

データ解析や低レイヤーの通信プロトコルを扱う処理では、こうした進数変換が必要になる場面が多いため覚えておくと便利です。

指定できる基数の範囲は、Character.MIN_RADIX（2）からCharacter.MAX_RADIX（36）までとなっています。

実践的なバリデーション手法

parseIntを呼び出す前に、あらかじめ文字列が数値であるかどうかを確認したい場合もあります。

Java 21以降のモダンな開発環境においても、正規表現を用いたチェックは依然として有効な手段の一つです。

例えば、str.matches("-?\\d+")という正規表現を使用すれば、その文字列が整数であるかどうかを事前に判定できます。

また、Apache Commons Langなどの外部ライブラリを使用している場合は、NumberUtils.isCreatable()といった便利なユーティリティメソッドを利用することも可能です。

ただし、最も確実かつJava標準の仕様に準拠した方法は、やはりtry-catchによる例外捕捉です。

パフォーマンスが極端に求められるループ内などの特殊な状況を除き、標準的な例外処理を用いることを推奨します。

null値への配慮とOptionalの活用

2026年現在のモダンなJava開発では、null安全性を高めるためにOptionalクラスを活用することが一般的です。

文字列がnullである可能性がある場合、直接parseIntに渡すと実行時エラーの原因となります。

以下のように、Optionalと組み合わせて「値が存在し、かつ数値変換が成功した場合のみ処理を継続する」といった流れるような記述が可能です。

Java
import java.util.Optional;

public class OptionalParse {
    public static void main(String[] args) {
        String input = null;

        int result = Optional.ofNullable(input)
                .filter(s -> s.matches("-?\\d+"))
                .map(Integer::parseInt)
                .orElse(0); // デフォルト値を指定

        System.out.println("結果: " + result);
    }
}

このような書き方をすることで、コードの可読性が向上し、意図しないクラッシュを防ぐことができます。

まとめ

JavaにおけるStringからintへの変換は、Integer.parseIntを正しく理解し活用することが基本となります。

単に変換を行うだけでなく、Integer.valueOfとの使い分けや、NumberFormatExceptionへの適切な対策を行うことが、高品質なコードを書くための第一歩です。

特に、外部入力を扱う際には、本記事で紹介した例外処理やバリデーション、進数指定などのテクニックを駆使して、堅牢なプログラムを目指しましょう。

Javaのバージョンが進むにつれて周辺の言語仕様は進化していますが、この数値変換の基本原則は今後も変わらず重要な要素であり続けます。

今回学んだ内容を、日々の開発業務や学習に役立てていただければ幸いです。

URLをコピーしました！