CKTIS / Java
Parametri varargs v Javi: String... in T...
V Java SE 21 lahko parametru varargs podamo posamezne argumente ali obstoječo tabelo. Pri `T...` lahko brisanje tipov privede do onesnaženja kopice.
Različica: Java SE 21
Sintaksa
static void labels(String... values) { /* values has type String[] */ }
static <T> int count(T... values) { return values.length; }V Java SE 21 zapis ... za tipom označuje parameter varargs. Metoda ali konstruktor ima lahko največ en tak parameter, ki mora biti zadnji. V telesu metode ima String... values tip String[]; v generični metodi s tipskim parametrom <T> ima T... values tip T[].
Pri klicu s spremenljivim številom argumentov prevajalnik poskrbi, da se končni argumenti zberejo v novo tabelo. labels() prejme prazno tabelo, ne null. Če je klic mogoč brez združevanja argumentov, se združljiva tabela poda brez kopiranja: spremembe njenih elementov so vidne tudi klicatelju. Pri prikazani metodi labels(null) in labels((String[]) null) podata ničelno referenco namesto tabele; branje length bi sprožilo NullPointerException. labels((String) null) poda tabelo z enim elementom null.
Pri izbiri preobremenjene metode prevajalnik najprej išče ujemanje brez združevanja: najprej brez pretvorb boxing in unboxing, nato z njima. Združevanje upošteva šele, če v nobeni od teh faz ne najde ustrezne metode. Metodo varargs lahko zato izbere že v fazi s fiksnim številom argumentov. labels(String...) in labels(String[]) imata enak podpis in ne moreta biti ločeni preobremenitvi.
String je reificiran tip: med izvajanjem je njegov tip v celoti na voljo. T ni reificiran; pri združevanju nova tabela dobi tip, ki nastane z brisanjem tipa tabele, določenega za klic. Prevajalnik izda opozorilo unchecked pri deklaraciji, opozori pa lahko tudi pri klicu. Če je ista tabela dosegljiva prek reference tipa Object[], lahko zapis krši jamstva generičnih tipov. To onesnaženje kopice se lahko pokaže šele pri branju kot ClassCastException.
@SafeVarargs je zagotovilo avtorja, ne preverjanje med izvajanjem. Zatre ta opozorila pri deklaraciji in na mestih klica. Dovoljena je na konstruktorjih varargs in metodah varargs z oznako static, final ali private. Uporabi jo šele, ko preveriš, da se tabela ne uporablja niti ne izpostavlja na nevaren način.
Primeri
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")));
}
}Rezultat
[] [red, blue] [green] [null] null 2
`[]` je prazna tabela, `[null]` je tabela z enim elementom `null`, `null` pa pomeni, da tabele ni. `count` prebere samo dolžino tabele: prešteje dva seznama, ne treh nizov.
Povezane lekcije
- Java · Lekcija 3 · Napredna · Različica: 2
- Java · Lekcija 14 · Napredna · Različica: 2
Viri
- 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