Java可變長度參數

術語「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（）方法的簽名必須是main（String [] args）。Main類的main（）方法的以下聲明是有效的。

public class Main {
  public static void main(String... args) {
    System.out.println("Hello from  varargs main()...");
  }
}