PricingLoginStart free
Java Academy · Oppitunti

Varargs-parametrit

Määritä metodeja, jotka hyväksyvät vaihtelevan pituisia argumenttilistoja, ja yhdistä ne taulukoihin.

Oppitunti 2/413 vaihetta

Varargs-parametrit on ilmainen Java Academy-oppitunti CoddyKitissä. Tämä on oppitunti 2/4. Voit lukea koko oppitunnin alta ilmaiseksi ja harjoitella sen jälkeen käytännössä selaimessa sisäänrakennetulla koodieditorilla ja ympäri vuorokauden käytettävissä olevan tekoälytuutorin avulla. Oppitunti kuuluu Java Academy-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Java Academy-kurssilla on yhteensä 4 oppituntia.

Varargs-parametrit

Varargs-parametrien eli vaihtelevan pituisten argumenttilistojen avulla voit määrittää metodeja, jotka hyväksyvät mielivaltaisen määrän samantyyppisiä argumentteja. Metodissa niitä käsitellään taulukkona.

Varargs-parametrin määrittäminen

Käytä varargs-parametrille muotoa Type... name. Sen on oltava viimeinen parametri, ja metodissa voi olla vain yksi tällainen parametri.

static int sum(int... numbers) {
    int total = 0;
    for (int n : numbers) total += n;
    return total;
}

System.out.println(sum());           // 0 (empty array)
System.out.println(sum(1));          // 1
System.out.println(sum(1, 2, 3));    // 6
System.out.println(sum(1, 2, 3, 4)); // 10

// Can also pass an array
int[] arr = {5, 10, 15};
System.out.println(sum(arr));        // 30

Varargs-parametrit sisäisesti

Varargs on syntaktista sokeria. Kääntäjä muuttaa kutsun taulukon luonniksi kutsukohdassa.

// Calling: sum(1, 2, 3)
// Compiler generates: sum(new int[]{1, 2, 3})

static void printAll(String label, String... items) {
    System.out.println(label + ":");
    for (String item : items) System.out.println("  - " + item);
}

printAll("Fruits", "Apple", "Banana", "Cherry");
// Fruits:
//   - Apple
//   - Banana
//   - Cherry

printAll("Empty"); // varargs is empty array

Varargs-parametrit muiden parametrien kanssa

Varargs-parametrin on oltava viimeinen parametri. Sen edellä voi käyttää tavallisia parametreja.

static double average(String label, double... values) {
    if (values.length == 0) return 0.0;
    double sum = 0;
    for (double v : values) sum += v;
    double avg = sum / values.length;
    System.out.printf("%s average: %.2f%n", label, avg);
    return avg;
}

average("Math scores", 92.0, 85.5, 78.0, 95.0);
// Math scores average: 87.62

average("Single value", 100.0);
// Single value average: 100.00

Varargs ja geneeriset tyypit

Varargs-parametrien käyttäminen geneeristen tyyppien kanssa aiheuttaa heap pollution -varoituksen. Varoituksen voi vaimentaa käyttämällä @SafeVarargs-annotaatiota, kun metodin turvallisuus voidaan osoittaa.

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

@SafeVarargs  // suppresses heap pollution warning
static <T> List<T> listOf(T... elements) {
    return Arrays.asList(elements); // safe: we don't store to the array
}

List<String> names = listOf("Alice", "Bob", "Charlie");
System.out.println(names); // [Alice, Bob, Charlie]

List<Integer> scores = listOf(95, 87, 73);
System.out.println(scores); // [95, 87, 73]

Varargs ja ylikuormitus

Kun varargs-metodilla on ylikuormitus, joka vastaa kutsua täsmällisesti, täsmällinen vastaavuus on ensisijainen. Varargs on viimeinen vaihtoehto.

static void log(String msg)         { System.out.println("1-arg: " + msg); }
static void log(String m1, String m2) { System.out.println("2-arg: " + m1 + ", " + m2); }
static void log(String... msgs)        { System.out.println("varargs: " + msgs.length); }

log("hello");          // 1-arg: hello
log("a", "b");         // 2-arg: a, b
log("a", "b", "c");   // varargs: 3
log();                  // varargs: 0

printf käyttää varargs-parametreja

System.out.printf käyttää varargs-parametreja — se hyväksyy muotoilumerkkijonon ja mielivaltaisen määrän minkä tahansa tyyppisiä argumentteja.

// printf signature: printf(String format, Object... args)
System.out.printf("%s ordered %d items for $%.2f%n",
    "Alice", 3, 59.97);
// Alice ordered 3 items for $59.97

// String.format is also varargs
String msg = String.format("Error %d: %s", 404, "Not Found");
System.out.println(msg); // Error 404: Not Found

Kirjaajan rakentaminen varargs-parametreilla

Yksinkertaisen rakenteisen kirjaajan toteuttaminen siten, että se hyväksyy avain–arvo-pareja varargs-parametrien avulla.

static void logEvent(String event, Object... keyValues) {
    if (keyValues.length % 2 != 0)
        throw new IllegalArgumentException("Key-value pairs required");
    StringBuilder sb = new StringBuilder(event);
    for (int i = 0; i < keyValues.length; i += 2)
        sb.append(" ").append(keyValues[i]).append("=").append(keyValues[i+1]);
    System.out.println(sb);
}

logEvent("user.login",  "userId", 42, "ip", "192.168.1.1", "success", true);
// user.login userId=42 ip=192.168.1.1 success=true

Suorituskykynäkökohta

Jokainen varargs-kutsu luo keolle uuden taulukon. Jos apumetodia kutsutaan usein, määritä sille kiinteän ariteetin ylikuormituksia varauksen välttämiseksi.

// Java's own EnumSet does this:
static <E extends Enum<E>> EnumSet<E> of(E e)              { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E e2)       { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3) { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E... rest)  { ... }
// Avoids array creation for 1-3 args (most common case)

// Apply the same pattern to your own hot-path APIs:
static void report(String msg)             { log(new String[]{msg}); }
static void report(String m1, String m2)   { log(new String[]{m1, m2}); }
static void report(String... msgs)         { log(msgs); }

Varargs ja null

null-arvon välittäminen varargs-metodille aiheuttaa epäselvyyttä — Java saattaa tulkita sen null-taulukoksi. Käytä eksplisiittistä tyyppimuunnosta varoituksen välttämiseksi.

static void printItems(String... items) {
    if (items == null) {
        System.out.println("null array passed");
        return;
    }
    for (String item : items)
        System.out.println(item != null ? item : "(null element)");
}

printItems((String[]) null); // null array passed
printItems(null, "valid");   // (null element), valid
printItems();                 // empty array (0 items)

Käytännössä: String-muotoiluapumetodi

Turvallinen printf-kääre, joka palauttaa muotoillun merkkijonon ja käyttää varargs-parametreja format-args-tyylin mukaisesti.

static String fmt(String pattern, Object... args) {
    try {
        return String.format(pattern, args);
    } catch (java.util.IllegalFormatException e) {
        return "[FORMAT ERROR: " + e.getMessage() + "]";
    }
}

System.out.println(fmt("User %s has %d orders", "Alice", 5));
// User Alice has 5 orders

System.out.println(fmt("Invalid %z format", "arg"));
// [FORMAT ERROR: Conversion = 'z' ...]

Pikatarkistus

Mikä on varargs-parametrin tyyppi metodin rungon sisällä?

Vastaa interaktiivisessa oppitunnissa

Kertaus: varargs-parametrit

Keskeiset opit:

  • Varargs (Type... name) hyväksyy vähintään nolla argumenttia ja käsittelee ne sisäisesti taulukkona
  • Sen on oltava viimeinen parametri — metodissa voi olla vain yksi varargs-parametri
  • Kutsuja voi välittää yksittäisiä arvoja tai taulukon
  • Käytä @SafeVarargs-annotaatiota geneeristen varargs-parametrien heap pollution -varoitusten vaimentamiseen
  • Täsmällisesti vastaavat ylikuormitukset ovat ensisijaisia varargs-ylikuormituksiin nähden
  • Määritä usein kutsutuille metodeille kiinteän ariteetin ylikuormituksia taulukon luonnin välttämiseksi
Aloita maksutta

Opi Java tekoälytuutorin avulla — ilmaiseksi

Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.

Kurssit
104
Oppitunnit
374
Aloita opiskelu maksuttaNäytä koko kurssi

Usein kysytyt kysymykset

Onko oppitunti ”Varargs-parametrit” ilmainen?

Kyllä – oppitunnin ”Varargs-parametrit” koko tekstin voi lukea täällä verkossa ilmaiseksi. Jos haluat harjoitella interaktiivisesti sisäänrakennetulla koodieditorilla ja ympäri vuorokauden käytettävissä olevan tekoälytuutorin avulla sekä avata koko Java Academy-kurssin, päivitä CoddyKit PROhon. Java Academy-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”Varargs-parametrit”?

Määritä metodeja, jotka hyväksyvät vaihtelevan pituisia argumenttilistoja, ja yhdistä ne taulukoihin. Harjoittelet Java Academy-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni Java Academy-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin Java Academy-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 2/4.

Kuinka kauan ”Varargs-parametrit”-oppitunnin suorittaminen kestää?

Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.

Voinko kirjoittaa ja suorittaa koodia tällä Java Academy-oppitunnilla?

Kyllä. Jokainen Java Academy-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.

Kaikki tämän kurssin oppitunnit

  1. Metodien ylikuormituksen säännöt
  2. Varargs-parametrit
  3. Staattiset kentät ja vakiot
  4. Apuohjelmaluokat ja staattiset factory-metodit
← Takaisin: Java Academy