はじめに (対象読者・この記事でわかること)

この記事は、Javaプログラミングを始めたばかりの初学者の方や、CUI（コマンドラインインターフェース）アプリケーションにおけるユーザー入力の扱いに悩んでいる方を対象としています。

この記事を読むことで、Javaの標準入力からデータを受け取るためのScannerクラスの基本的な使い方から応用、そして多くの初心者が遭遇しやすい「ハマりどころ」とその解決策までを具体的に理解し、自信を持ってユーザー入力機能を実装できるようになります。Javaを使ったインタラクティブなプログラムを作成する第一歩として、ぜひお役立てください。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 - Javaの基本的な文法（変数、データ型、メソッドの呼び出しなど） - Java開発環境（JDK）がPCにセットアップされていること - コンソール（ターミナル）でのJavaプログラムの実行方法

Javaにおける標準入力とScannerクラスの役割

Javaでコンソールアプリケーションを開発する際、ユーザーからの入力を受け付けることは非常に重要です。例えば、ユーザー名を入力させたり、計算機で数値を入力させたりする場面が挙げられます。このような「標準入力」からのデータを受け取る際に、最も一般的に使われるクラスがjava.util.Scannerクラスです。

Scannerクラスは、様々なデータソース（キーボードからの標準入力、ファイル、文字列など）からテキストデータを読み込み、それをプリミティブ型（int、doubleなど）やString型にパース（解析）して取得する機能を提供します。単にバイト列として読み込むのではなく、区切り文字（デフォルトは空白）で分割したり、特定のデータ型として解釈したりする便利なメソッドが豊富に用意されているため、入力処理を非常にシンプルに記述できるのが大きなメリットです。

このクラスを使うことで、複雑な入力処理を意識することなく、ユーザーとのインタラクションを持つプログラムを簡単に実装できます。

Scannerクラスの具体的な使い方と注意点

ここからは、Scannerクラスの具体的な使い方をコード例を交えながら詳しく見ていきましょう。

ステップ1: Scannerクラスの基本とインスタンス化

Scannerクラスを使用するには、まずjava.utilパッケージからインポートし、System.in（標準入力ストリーム）を引数としてScannerオブジェクトをインスタンス化します。

Java

import java.util.Scanner; // Scannerクラスをインポート

public class ScannerBasic {
    public static void main(String[] args) {
        // System.in (標準入力) から読み込むScannerオブジェクトを作成
        Scanner scanner = new Scanner(System.in);

        System.out.print("何か入力してください: ");
        String input = scanner.nextLine(); // ユーザーからの1行の入力を読み込む
        System.out.println("入力された文字列: " + input);

        // Scannerオブジェクトは使用後に閉じる必要がある
        scanner.close(); 
    }
}

ポイント: - import java.util.Scanner;: Scannerクラスを使うには、この行が必要です。 - Scanner scanner = new Scanner(System.in);: System.inはキーボードからの入力を表します。 - scanner.close();: Scannerオブジェクトは、使い終わったら必ず閉じましょう。これを忘れると、リソースリーク（メモリやファイルハンドルなどのリソースが解放されない状態）の原因となることがあります。Java 7以降では、try-with-resources文を使うことで自動的に閉じることができます。

ステップ2: 各種データ型の入力

Scannerクラスには、さまざまなデータ型を読み込むための便利なメソッドが用意されています。

文字列の入力 (next() と nextLine())

文字列を読み込むには、next()またはnextLine()メソッドを使用します。

  • next(): 次の空白までのトークン（単語）を読み込みます。
  • nextLine(): 次の改行コードまでの行全体を読み込みます。
Java

import java.util.Scanner;

public class StringInput {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);

        System.out.print("姓を入力してください (例: 山田): ");
        String lastName = scanner.next(); // "山田" のみ読み込む

        System.out.print("名を入力してください (例: 太郎): ");
        String firstName = scanner.next(); // "太郎" のみ読み込む

        System.out.println("氏名: " + lastName + " " + firstName);

        // next()で読み込んだ後にnextLine()を使う場合、注意が必要
        // その問題は後述します。

        System.out.print("好きな言葉を教えてください (スペース含む): ");
        scanner.nextLine(); // 直前のnext()で残った改行文字を消費
        String favoritePhrase = scanner.nextLine(); // 行全体を読み込む
        System.out.println("あなたの好きな言葉: " + favoritePhrase);

        scanner.close();
    }
}

next()は空白で区切られた単語を読み込むため、スペースを含む文字列を入力したい場合はnextLine()を使用します。

数値の入力 (nextInt(), nextDouble(), nextFloat()など)

整数や小数を読み込むためのメソッドも用意されています。

  • nextInt(): 次の整数を読み込みます。
  • nextDouble(): 次の倍精度浮動小数点数を読み込みます。
  • nextFloat(): 次の単精度浮動小数点数を読み込みます。
  • nextBoolean(): 次の真偽値（"true"または"false"）を読み込みます。
Java

import java.util.Scanner;

public class NumberInput {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner(System.in)) { // try-with-resources で自動クローズ
            System.out.print("年齢を入力してください: ");
            int age = scanner.nextInt();
            System.out.println("あなたの年齢: " + age + "歳");

            System.out.print("身長を入力してください (例: 175.5): ");
            double height = scanner.nextDouble();
            System.out.println("あなたの身長: " + height + "cm");

            System.out.print("テストに合格しましたか？ (true/false): ");
            boolean passed = scanner.nextBoolean();
            System.out.println("合格状況: " + (passed ? "合格" : "不合格"));

        } catch (java.util.InputMismatchException e) {
            System.err.println("エラー: 不適切な形式の入力です。");
        }
    }
}

この例では、try-with-resources文を使用しています。これにより、Scannerオブジェクトが自動的に閉じられるため、scanner.close()を明示的に記述する必要がなくなります。また、数値以外の文字列を入力した際に発生するInputMismatchExceptionを捕捉するtry-catchブロックも追加しています。

ステップ3: 入力チェックとエラーハンドリング

ユーザーが意図しない形式のデータを入力した場合（例：数字を求められているのに文字を入力）、InputMismatchExceptionが発生し、プログラムが異常終了してしまいます。これを防ぐためには、入力値のチェックとエラーハンドリングが重要です。

Scannerクラスには、次のトークンが特定のデータ型として解釈できるかどうかを確認するためのhasNext系のメソッドがあります。

  • hasNextInt(): 次のトークンが整数として解釈できる場合trueを返します。
  • hasNextDouble(): 次のトークンが倍精度浮動小数点数として解釈できる場合trueを返します。
  • hasNextLine(): 次の行が存在する場合trueを返します。

これらをif文やwhileループと組み合わせて使うことで、堅牢な入力処理を作成できます。

Java

import java.util.Scanner;

public class InputValidation {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner(System.in)) {
            int age;
            while (true) {
                System.out.print("年齢を入力してください (整数): ");
                if (scanner.hasNextInt()) {
                    age = scanner.nextInt();
                    if (age > 0 && age < 150) { // 年齢の妥当性もチェック
                        break; // 有効な入力であればループを抜ける
                    } else {
                        System.out.println("年齢は1から149の間で入力してください。");
                    }
                } else {
                    System.out.println("エラー: 無効な入力です。整数を入力してください。");
                    scanner.next(); // 無効な入力をスキップして次の入力を待つ
                }
                scanner.nextLine(); // 次の入力のために、残っている改行文字を消費
            }
            System.out.println("あなたの年齢: " + age + "歳");
        }
    }
}

この例では、whileループを使って有効な整数が入力されるまで繰り返し入力を促しています。scanner.next()は、無効な入力を消費し、scanner.nextLine()は残りの行（主に改行文字）を消費して、次の入力で問題が発生しないようにしています。

ハマった点やエラー解決: nextInt() などの後に nextLine() を使うとスキップされる問題

Scannerクラスを使う上で、特に初心者が遭遇しやすいのが、nextInt()やnextDouble()などの数値入力メソッドの後にnextLine()を使うと、nextLine()がスキップされてしまう問題です。

問題の発生原因: nextInt()などのメソッドは、数値とそれに続く改行文字（\n）の直前までを読み込みます。そのため、入力ストリームには改行文字が残されたままになります。その直後にnextLine()を呼び出すと、nextLine()は残っている改行文字を「空の入力」として読み込んでしまい、ユーザーに新しい入力を促すことなく処理が進んでしまうのです。

具体例:

Java

import java.util.Scanner;

public class ScannerPitfall {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner(System.in)) {
            System.out.print("あなたの好きな数字を入力してください: ");
            int number = scanner.nextInt();
            System.out.println("好きな数字: " + number);

            System.out.print("あなたの好きな食べ物を入力してください: ");
            // ここでnextLine()がスキップされてしまう！
            String food = scanner.nextLine(); 
            System.out.println("好きな食べ物: " + food);
        }
    }
}

上記のコードを実行し、数字を入力してEnterキーを押すと、好きな食べ物の入力が促されることなくプログラムが終了するか、food変数に空文字列が代入されてしまいます。

解決策

この問題には、いくつかの解決策があります。

解決策1: 数値入力メソッドの後に nextLine() を一度呼び出す

最も一般的な解決策は、nextInt()などの数値入力メソッドの直後に、scanner.nextLine()をもう一度呼び出して、残された改行文字を消費することです。

Java

import java.util.Scanner;

public class ScannerSolution1 {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner(System.in)) {
            System.out.print("あなたの好きな数字を入力してください: ");
            int number = scanner.nextInt();
            System.out.println("好きな数字: " + number);

            // ここで残った改行文字を消費する
            scanner.nextLine(); 

            System.out.print("あなたの好きな食べ物を入力してください: ");
            String food = scanner.nextLine(); 
            System.out.println("好きな食べ物: " + food);
        }
    }
}

これにより、food変数の入力前に改行文字が消費されるため、正しく文字列を入力できるようになります。

策2: 全て nextLine() で読み込み、型変換する

別の方法は、すべての入力をnextLine()で文字列として読み込み、必要に応じてInteger.parseInt()やDouble.parseDouble()などのメソッドで型変換することです。この方法だと、改行文字の問題を意識する必要がなくなります。

Java

import java.util.Scanner;

public class ScannerSolution2 {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner(System.in)) {
            System.out.print("あなたの好きな数字を入力してください: ");
            String numberStr = scanner.nextLine(); // まず文字列として読み込む
            int number = Integer.parseInt(numberStr); // 整数に変換
            System.out.println("好きな数字: " + number);

            System.out.print("あなたの好きな食べ物を入力してください: ");
            String food = scanner.nextLine(); // 行全体を読み込む
            System.out.println("好きな食べ物: " + food);
        } catch (NumberFormatException e) {
            System.err.println("エラー: 数字の形式が不正です。");
        }
    }
}

この方法では、NumberFormatExceptionが発生する可能性があるため、try-catchブロックで適切にエラーハンドリングを行うことが重要です。

どちらの解決策も有効ですが、状況や個人の好みに応じて使い分けると良いでしょう。

まとめ

本記事では、Javaプログラミングにおけるユーザー入力の基本となるScannerクラスについて徹底的に解説しました。

  • Scannerクラスの基本: new Scanner(System.in)でインスタンス化し、scanner.close()またはtry-with-resourcesで確実にリソースを解放します。
  • 各種データ型の入力: next()、nextLine()、nextInt()、nextDouble()など、用途に応じたメソッドを使います。
  • 入力値の検証とエラーハンドリング: hasNextInt()などのメソッドとtry-catch文を組み合わせることで、堅牢な入力処理を実装できます。
  • nextInt()後のnextLine()問題: 数値入力後にnextLine()がスキップされる問題は、間にscanner.nextLine()を挟むか、すべてnextLine()で読み込んで型変換することで解決できます。

この記事を通して、JavaでのCUI入力処理の仕組みと効果的な使い方を理解し、遭遇しやすい問題への対処法を学ぶことで、皆さんがよりスムーズにJavaアプリケーションを開発できるようになることを願っています。

今後は、BufferedReaderクラスとの比較や、ファイルからのデータ読み込みといった発展的な内容についても記事にする予定です。

参考資料