可変長引数パラメーター
可変長の引数リストを受け取るメソッドを定義し、配列と組み合わせます。
「可変長引数パラメーター」はCoddyKit上の無料Java Academyレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはJava Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Java Academyコースには全4レッスンが含まれています。
可変長引数
Varargs（可変長引数リスト）を使うと、同じ型の引数を任意の個数受け取るメソッドを定義できます。内部では配列として扱われます。
可変長引数の宣言
可変長引数のパラメータにはType... nameを使用します。必ず最後のパラメータにする必要があり、1つのメソッドにつき1つしか指定できません。
static int sum(int... numbers) {
int total = 0;
for (int n : numbers) total += n;
return total;
}
System.out.println(sum()); // 0 (empty array)
System.out.println(sum(1)); // 1
System.out.println(sum(1, 2, 3)); // 6
System.out.println(sum(1, 2, 3, 4)); // 10
// Can also pass an array
int[] arr = {5, 10, 15};
System.out.println(sum(arr)); // 30可変長引数の内部動作
Varargsは構文糖です。コンパイラによって、呼び出し箇所で配列を生成する処理に変換されます。
// Calling: sum(1, 2, 3)
// Compiler generates: sum(new int[]{1, 2, 3})
static void printAll(String label, String... items) {
System.out.println(label + ":");
for (String item : items) System.out.println(" - " + item);
}
printAll("Fruits", "Apple", "Banana", "Cherry");
// Fruits:
// - Apple
// - Banana
// - Cherry
printAll("Empty"); // varargs is empty array可変長引数と通常のパラメータ
可変長引数は最後のパラメータでなければなりません。その前に通常のパラメータを組み合わせることはできます。
static double average(String label, double... values) {
if (values.length == 0) return 0.0;
double sum = 0;
for (double v : values) sum += v;
double avg = sum / values.length;
System.out.printf("%s average: %.2f%n", label, avg);
return avg;
}
average("Math scores", 92.0, 85.5, 78.0, 95.0);
// Math scores average: 87.62
average("Single value", 100.0);
// Single value average: 100.00ジェネリック型と可変長引数
ジェネリクスで可変長引数を使用すると、ヒープ汚染の警告が発生します。メソッドが安全であることを証明できる場合は、@SafeVarargsで警告を抑制します。
import java.util.Arrays;
import java.util.List;
@SafeVarargs // suppresses heap pollution warning
static <T> List<T> listOf(T... elements) {
return Arrays.asList(elements); // safe: we don't store to the array
}
List<String> names = listOf("Alice", "Bob", "Charlie");
System.out.println(names); // [Alice, Bob, Charlie]
List<Integer> scores = listOf(95, 87, 73);
System.out.println(scores); // [95, 87, 73]可変長引数とオーバーロード
可変長引数のメソッドが完全一致するメソッドとオーバーロードされている場合は、完全一致するメソッドが優先されます。可変長引数は最後の選択肢です。
static void log(String msg) { System.out.println("1-arg: " + msg); }
static void log(String m1, String m2) { System.out.println("2-arg: " + m1 + ", " + m2); }
static void log(String... msgs) { System.out.println("varargs: " + msgs.length); }
log("hello"); // 1-arg: hello
log("a", "b"); // 2-arg: a, b
log("a", "b", "c"); // varargs: 3
log(); // varargs: 0printfは可変長引数
System.out.printfは可変長引数を使用します。書式文字列と、任意の型の引数を任意の個数受け取ります。
// printf signature: printf(String format, Object... args)
System.out.printf("%s ordered %d items for $%.2f%n",
"Alice", 3, 59.97);
// Alice ordered 3 items for $59.97
// String.format is also varargs
String msg = String.format("Error %d: %s", 404, "Not Found");
System.out.println(msg); // Error 404: Not Found可変長引数を使ったロガーの構築
可変長引数を使ってキーと値のペアを受け取る、シンプルな構造化ロガーを実装します。
static void logEvent(String event, Object... keyValues) {
if (keyValues.length % 2 != 0)
throw new IllegalArgumentException("Key-value pairs required");
StringBuilder sb = new StringBuilder(event);
for (int i = 0; i < keyValues.length; i += 2)
sb.append(" ").append(keyValues[i]).append("=").append(keyValues[i+1]);
System.out.println(sb);
}
logEvent("user.login", "userId", 42, "ip", "192.168.1.1", "success", true);
// user.login userId=42 ip=192.168.1.1 success=trueパフォーマンスに関する考慮事項
可変長引数を使うたびに、ヒープ上に新しい配列が作成されます。高頻度で呼び出されるユーティリティメソッドでは、割り当てを避けるために引数個数固定のオーバーロードを用意します。
// Java's own EnumSet does this:
static <E extends Enum<E>> EnumSet<E> of(E e) { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E e2) { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3) { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E... rest) { ... }
// Avoids array creation for 1-3 args (most common case)
// Apply the same pattern to your own hot-path APIs:
static void report(String msg) { log(new String[]{msg}); }
static void report(String m1, String m2) { log(new String[]{m1, m2}); }
static void report(String... msgs) { log(msgs); }可変長引数とnull
可変長引数のメソッドにnullを渡すとあいまいになります。Javaがnull配列として解釈する可能性があるためです。警告を避けるには明示的にキャストします。
static void printItems(String... items) {
if (items == null) {
System.out.println("null array passed");
return;
}
for (String item : items)
System.out.println(item != null ? item : "(null element)");
}
printItems((String[]) null); // null array passed
printItems(null, "valid"); // (null element), valid
printItems(); // empty array (0 items)実践：String formatヘルパー
可変長引数を使ってformat-args形式に対応する、安全なprintfラッパーを実装します。整形済みの文字列を返します。
static String fmt(String pattern, Object... args) {
try {
return String.format(pattern, args);
} catch (java.util.IllegalFormatException e) {
return "[FORMAT ERROR: " + e.getMessage() + "]";
}
}
System.out.println(fmt("User %s has %d orders", "Alice", 5));
// User Alice has 5 orders
System.out.println(fmt("Invalid %z format", "arg"));
// [FORMAT ERROR: Conversion = 'z' ...]理解度チェック
メソッド本体内では、可変長引数のパラメータはどの型になりますか？
まとめ：可変長引数
重要なポイント：
- 可変長引数（Type... name）は、内部では配列として0個以上の引数を受け取ります
- 最後のパラメータでなければならず、1つのメソッドにつき1つしか指定できません
- 呼び出し側は個別の値または配列を渡せます
- ジェネリック型の可変長引数で発生するヒープ汚染の警告を抑制するには、@SafeVarargsを使用します
- 完全一致するオーバーロードは、可変長引数のオーバーロードより優先されます
- 頻繁に呼び出されるメソッドでは、配列の割り当てを避けるために引数個数固定のオーバーロードを用意します
よくある質問
「可変長引数パラメーター」レッスンは無料ですか？
はい。「可変長引数パラメーター」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Java Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Java Academyコースには全4レッスンが含まれています。
「可変長引数パラメーター」で何を学びますか？
可変長の引数リストを受け取るメソッドを定義し、配列と組み合わせます。 ブラウザで直接実行するハンズオンコードでJava Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Java Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのJava Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。
「可変長引数パラメーター」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このJava Academyレッスンでコードを書いて実行できますか？
はい。すべてのJava Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。