Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Parametry varargs v Javě: String... a T...

V Java SE 21 lze parametru varargs předat jednotlivé argumenty nebo hotové pole. U `T...` může kvůli mazání typů dojít ke znečištění haldy.

Verze: Java SE 21

Syntaxe

static void labels(String... values) { /* values has type String[] */ }
static <T> int count(T... values) { return values.length; }

V Java SE 21 označuje zápis ... za typem parametr varargs. Metoda nebo konstruktor smí mít nejvýše jeden takový parametr a ten musí být poslední. V těle metody má String... values typ String[]; v generické metodě s typovým parametrem <T> má T... values typ T[].

Při volání s proměnným počtem argumentů překladač zajistí uložení koncových argumentů do nového pole. labels() dostane prázdné pole, nikoli null. Pokud volání vyhovuje bez zabalení argumentů, kompatibilní pole se předá bez kopírování: volající vidí změny jeho prvků. U uvedené metody předávají labels(null) a labels((String[]) null) nulovou referenci na pole; čtení length by vyvolalo NullPointerException. labels((String) null) předá pole s jedním prvkem null.

Při výběru přetížené metody překladač nejprve hledá shodu bez zabalení: nejdřív bez boxingu a unboxingu, poté s oběma. O zabalení uvažuje až tehdy, když ani jedna fáze nenajde použitelnou metodu. Metodu varargs tak může vybrat už ve fázi s pevným počtem argumentů. labels(String...) a labels(String[]) mají stejnou signaturu a nemohou být samostatnými přetíženími.

String je reifikovatelný typ: jeho typ je za běhu plně dostupný. T reifikovatelný není; při zabalení má nové pole typ získaný vymazáním typu pole určeného pro dané volání. Překladač vydá varování unchecked u deklarace a může varovat i při volání. Pokud na stejné pole odkazuje reference typu Object[], zápis může porušit záruky generických typů. Toto znečištění haldy se může projevit až při čtení výjimkou ClassCastException.

@SafeVarargs je prohlášení autora, nikoli kontrola za běhu. Potlačuje tato varování u deklarace i v místech volání. Lze ji použít u konstruktorů varargs a metod varargs označených static, final nebo private. Používej ji až po ověření, že se pole nepoužívá ani nezpřístupňuje nebezpečným způsobem.

Příklady

import java.util.Arrays;
import java.util.List;

public class VarargsDemo {
    static void labels(String... values) {
        System.out.println(Arrays.toString(values));
    }

    @SafeVarargs
    static <T> int count(T... values) {
        return values.length;
    }

    public static void main(String[] args) {
        labels();
        labels("red", "blue");
        labels(new String[]{"green"});
        labels((String) null);
        labels((String[]) null);
        System.out.println(count(List.of("red", "blue"), List.of("green")));
    }
}

Výsledek

[]
[red, blue]
[green]
[null]
null
2

`[]` je prázdné pole, `[null]` je pole s jedním prvkem `null` a `null` znamená, že žádné pole nebylo předáno. `count` čte jen délku pole: počítá dva seznamy, ne tři řetězce.

Související lekce

  • Java · Lekce 3 · Pokročilá · Verze: 2
  • Java · Lekce 14 · Pokročilá · Verze: 2

Zdroje