Java の可変長引数（Varargs）: 任意の数の引数を受け取るメソッド

1つのメソッドで任意の数の引数

メソッドにいくつ引数が必要か、あらかじめ分からないことがあります。あるときは max(3, 9) を、次の瞬間には max(1, 7, 4, 2, 8) を使いたくなるかもしれません。可変長引数がなければ、引数の数ごとにオーバーロードを書くか、呼び出し側に配列を作らせるしかありません。可変長引数（variable arguments の略）を使うと、1つのメソッドで同じ型の値を 0 個、1 個、または多数受け取れます。

パラメータの型のうしろにドット3つ（...）を付けて宣言します:

public class Main {
    static int sum(int... numbers) {
        int total = 0;
        for (int n : numbers) {   // numbers は単なる int[]
            total += n;
        }
        return total;
    }

    public static void main(String[] args) {
        System.out.println(sum(1, 2, 3));        // 6
        System.out.println(sum(10, 20));         // 30
        System.out.println(sum());               // 0 - 引数ゼロも許される
        System.out.println(sum(4, 8, 15, 16));   // 43
    }
}

呼び出し側はばらばらの値を渡し、メソッド内では numbers は本物の配列になります。これがすべてのポイントです。コンパイラが引数をまとめて配列にしてくれるのです。

可変長引数は単なる配列

実行時に魔法はありません。int... numbers と宣言されたパラメータは、メソッドに入った時点でまさに int[] です。length を調べ、添字でアクセスし、他の配列と同じようにループで回せます。

public class Main {
    static String join(String separator, String... parts) {
        if (parts.length == 0) {
            return "";
        }
        StringBuilder sb = new StringBuilder(parts[0]);
        for (int i = 1; i < parts.length; i++) {
            sb.append(separator).append(parts[i]);
        }
        return sb.toString();
    }

    public static void main(String[] args) {
        System.out.println(join("-", "2026", "06", "04"));  // 2026-06-04
        System.out.println(join(", ", "alone"));            // alone
    }
}

本当に配列なので、すでに持っている配列を可変長引数のメソッドに渡すこともできます。どちらの形式も受け取れます:

public class Main {
    static int sum(int... numbers) {
        int total = 0;
        for (int n : numbers) total += n;
        return total;
    }

    public static void main(String[] args) {
        int[] data = {5, 10, 15};
        System.out.println(sum(data));        // 既存の配列を渡す
        System.out.println(sum(1, 2, 3, 4));  // またはばらばらの値
    }
}

ルール: 最後に、そして1つだけ

2つのルールが可変長引数をあいまいでなく保ち、コンパイラはその両方を強制します:

1. 可変長引数のパラメータは最後でなければならない。 通常のパラメータが先に来て、そのあと ... パラメータが残りをすべて吸収します。
2. メソッドが持てる可変長引数は最大で1つ。 2つあると、どこで一方が終わり、もう一方が始まるのかを見分けることが不可能になります。

public class Main {
    // OK: 通常のパラメータが先、可変長引数が最後
    static void log(String level, Object... values) {
        System.out.print("[" + level + "] ");
        for (Object v : values) {
            System.out.print(v + " ");
        }
        System.out.println();
    }

    public static void main(String[] args) {
        log("INFO", "user", 42, true);
        log("WARN");   // 可変長引数の部分は空でもよい
    }
}

これはコンパイルできます。しかし可変長引数を先に置くと（static void log(Object... values, String level)）コンパイルエラーになります: varargs parameter must be the last。必須パラメータ level は常に ... より前に来ます。

すでに可変長引数を使っている場所

実はずっと可変長引数のメソッドを呼んできました。System.out.printf と String.format が典型例で、その第2パラメータは Object... args です:

public class Main {
    public static void main(String[] args) {
        System.out.printf("%s scored %d points (%.1f%%)%n", "Ada", 95, 95.0);

        String row = String.format("%-8s | %5d", "banana", 30);
        System.out.println(row);
    }
}

List.of(...)、Arrays.asList(...)、そして多くのビルダー風 API も可変長引数です。だからこそ、自分で配列に包まなくても任意の数の要素を渡せるのです。

可変長引数とオーバーロード

可変長引数とオーバーロードは、1つ意外な形で影響し合います。通常のオーバーロードと可変長引数のオーバーロードがどちらも呼び出しに一致しうる場合、Java は より具体的な ほう、つまり引数の数が固定のメソッドを優先します:

public class Main {
    static String pick(int a, int b) {
        return "two-arg version";
    }

    static String pick(int... nums) {
        return "varargs version";
    }

    public static void main(String[] args) {
        System.out.println(pick(1, 2));      // two-arg version (より具体的)
        System.out.println(pick(1, 2, 3));   // varargs version
        System.out.println(pick());          // varargs version
    }
}

pick(1, 2) は両方に一致しますが、Java はより近い適合である可変長引数でないオーバーロードを選びます。可変長引数のメソッドは、引数の数が固定のオーバーロードがどれも一致しないときにだけ実行されます。たいていはこれが望む動作ですが、可変長引数のオーバーロードを追加すると、呼び出しがどのメソッドに解決されるかが知らないうちに変わってしまうことがある、ということでもあります。

空呼び出しと null 呼び出しに注意

2つの落とし穴が人をつまずかせます。1つ目: 可変長引数のメソッドを引数なしで呼ぶと、メソッドに渡されるのは null ではなく 空の配列 です。したがって numbers.length は 0 で、ループは何もしません。引数なしのケースに null チェックは不要です:

public class Main {
    static int count(Object... items) {
        return items.length;   // count() では 0、NPE には決してならない
    }

    public static void main(String[] args) {
        System.out.println(count());            // 0
        System.out.println(count("a", "b"));    // 2
    }
}

2つ目: リテラルの null を渡すのはあいまいで危険です。Java は count(null) を「null の要素が1つ」ではなく「可変長引数の配列全体が null」と解釈することがあり、その length を読んだときに NullPointerException を投げます。本当に null の要素を1つ渡したいなら、count((Object) null) のように明示してください。

次は: クラス

可変長引数は、メソッドパラメータでできることを総仕上げします。オーバーロードに加えて柔軟な引数リストが手に入ります。ここまでメソッドは static を付けてクラスの中にゆるく置かれていました。次は、クラスが本当はどう動くのかを見ていきます。データ（フィールド）とふるまい（メソッド）を自分の型にまとめること、それがオブジェクト指向 Java の核心です。