Что означают три точки (…) в параметрах метода в Java?

Что такое varargs (три точки) в Java?

Три точки ... в объявлении параметра метода в Java означают varargs (variable-length arguments — аргументы переменной длины). Эта конструкция позволяет передавать в метод произвольное количество значений одного типа, включая ноль значений. Внутри метода эти аргументы обрабатываются как обычный массив.

Как это работает?

Когда вы пишете int... numbers, Java автоматически преобразует все переданные аргументы в массив типа int[]. При этом:

• Вы можете передать любое количество значений через запятую: printNumbers(1, 2, 3)
• Вы можете передать массив напрямую: printNumbers(new int[]{4, 5})
• Вы можете не передавать ничего: printNumbers() — в этом случае массив будет пустым (длины 0)

Пример кода с пояснениями

public class VarargsExample {
    
    // Объявление метода с varargs
    public static void printNumbers(String message, int... numbers) {
        System.out.println(message + ": передано " + numbers.length + " чисел");
        for (int num : numbers) {
            System.out.print(num + " ");
        }
        System.out.println();
    }
    
    public static void main(String[] args) {
        // Способ 1: передача нескольких значений
        printNumbers("Три числа", 10, 20, 30);
        
        // Способ 2: передача массива
        int[] array = {100, 200, 300};
        printNumbers("Массив", array);
        
        // Способ 3: без аргументов
        printNumbers("Нет чисел");
        
        // Способ 4: одно значение
        printNumbers("Одно число", 42);
    }
}

Важные правила использования varargs

• Только один varargs-параметр — в методе может быть только один параметр с тремя точками
• Varargs должен быть последним — если есть другие параметры, varargs указывается самым последним (как String message в примере выше)
• Нельзя смешивать — нельзя передать и отдельные значения, и массив одновременно в одном вызове (но можно передать массив, содержащий все нужные значения)

Когда использовать varargs?

Varargs удобны в следующих ситуациях:

• Методы форматирования — например, String.format() или System.out.printf()
• Методы, которые могут принимать разное количество аргументов — например, метод сложения чисел
• Упрощение API — вместо создания массива каждый раз можно просто перечислить значения

Подводные камни

Будьте осторожны с перегрузкой методов, использующих varargs. Например:

public void method(int... nums) { }
public void method(int a, int b) { }

Вызов method(1, 2) может быть неоднозначным. Java в таких случаях выберет более специфичную версию (без varargs), но лучше избегать таких ситуаций.

printNumbers(1, 2, 3);

printNumbers(new int[]{1, 2, 3});

public void printNumbers(List<Integer> numbers) {
    for (int num : numbers) {
        System.out.println(num);
    }
}

// Вызов:
printNumbers(Arrays.asList(1, 2, 3));