術語「varargs」是」variable-length arguments」(可變長度引數)的縮寫。
可變長度引數宣告一個接受可變數量的引數（或引數）的方法或建構函式。
要宣告可變長度引數，在方法引數的資料型別之後新增一個省略號...。下面的程式碼顯示了一個帶有一個可變長度引數num 的 max（）方法宣告，它是int資料型別。
public static int max(int... num) {
}
省略號...之前和之後新增空格是可選的。可變長度引數方法可以有多個引數。 下面的程式碼顯示aMethod（）接受三個引數，其中一個是可變長度引數：
public static int aMethod(String str, double d1, int...num) {
}
方法最多可以有一個可變長度引數。可變長度引數方法的可變長度引數必須是引數列表中的最後一個引數。
void m2(String str, int...n1) {
}
重寫上面的 max（）方法，使其成為可變長度引數方法：
public class Main {
public static int max(int... num) {
int max = Integer.MIN_VALUE;
for (int i = 0; i < num.length; i++) {
if (num[i] > max) {
max = num[i];
}
}
return max;
}
}
可以使用for迴圈來處理可變長度引數的引數列表。length屬性給出了可變長度引數傳遞的值的數量。
要獲取可變長度引數中的第n個值，需要使用varArgsName [n-1]。可以使用foreach迴圈來處理可變長度引數。
public class Main {
// 求引數列表中的最大值...
public static int max2(int... num) {
int max = Integer.MIN_VALUE;
for (int currentNumber : num) {
if (currentNumber > max) {
max = currentNumber;
}
}
return max;
}
}
可以呼叫Main.max（）方法如下：
int max1 = Main.max(1, 8);
int max2 = Main.max(1, 1, 3);
對於方法中的可變長度引數，可以使用零個或多個引數。 以下程式碼是對max（）方法的有效呼叫：
int max = Main.max(); // Passing no argument is ok
max（）方法的以下宣告將強制其呼叫者至少傳遞兩個整數：
// Argumenets n1 and n2 are mandatory
public static int max(int n1, int n2, int... num) {
}
編譯器會將前兩個引數n1和n2視為強制性引數，將第三個引數num作為可選引數。
public class Main {
public static int max(int n1, int n2, int... num) {
// Initialize max to the maximum of n1 and n2
int max = (n1 > n2 ? n1 : n2);
for (int i = 0; i < num.length; i++) {
if (num[i] > max) {
max = num[i];
}
}
return max;
}
public static void main(String[] args) {
System.out.println(max(77, 99));
System.out.println(max(77, 99, 1010));
System.out.println(max(77, 99, 1010, 1313));
}
}
上面的程式碼生成以下結果。
方法過載規則適用於可變長度引數方法。可以使用可變長度引數過載一個方法，只要方法的引數在型別，順序或數位上不同。
例如，以下是一個過載的max（）方法的有效範例：
public class Main {
public static int max(int x, int y) {
}
public static int max(int...num) {
}
}
考慮下面的程式碼 -
int max = Main.max(12, 13); // which max() will be called?
Java將呼叫max（int x，int y）。 Java首先嘗試使用對引數數量的精確匹配來找到方法宣告。 如果沒有找到完全匹配，它將使用可變長度引數查詢匹配。
如果可變長度引數方法過載，Java使用該方法的其它特定版本，而不使用可變長度引數方法。 java使用可變長度引數方法作為解決方法呼叫的最後手段。
方法本身的過載可能是有效的。 但是，呼叫它可能會導致問題。
public class Main {
public static int max(int... num) {
return 0;
}
public static int max(double... num) {
return 0;
}
}
下面的程式碼呼叫哪個max（）方法？
int max = Main.max(); // Which max() to call?
上面的語句將生成一個編譯時錯誤。
main（）方法的簽名必須是main（String [] args）。Main類的main（）方法的以下宣告是有效的。
public class Main {
public static void main(String... args) {
System.out.println("Hello from varargs main()...");
}
}