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
- Java Language Specification, Java SE 21 — §8.4.1 Formal Parameters
- Java Language Specification, Java SE 21 — §8.4.2 Method Signature
- Java Language Specification, Java SE 21 — §15.12.2 Compile-Time Step 2: Determine Method Signature
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §4.7 Reifiable Types
- Java Language Specification, Java SE 21 — §4.12.2 Variables of Reference Type
- Java SE 21 API — SafeVarargs
- Java SE 21 API — Arrays.toString(Object[])
- JDK 21 Tool Specifications — The javac Command