术语“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()..."); } }