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

CKTIS / Java

Integer.valueOf: explicitní zabalení hodnoty int

Převeď primitivní `int` na objekt `Integer`, rozliš zabalení od parsování textu a zjisti, proč shoda referencí není spolehlivým testem rovnosti čísel.

Verze: Java SE 21

Syntaxe

public static Integer valueOf(int i)
public static Integer valueOf(String s) throws NumberFormatException
public static Integer valueOf(String s, int radix) throws NumberFormatException

Integer.valueOf je název přetížené statické metody třídy java.lang.Integer v Java SE 21. Integer.valueOf(int) vrací objekt Integer, který reprezentuje předanou primitivní hodnotu, bez parsování textu. Integer.valueOf(42) hodnotu zabalí explicitně (boxing), zatímco Integer n = 42; používá automatické zabalení (autoboxing). Přiřazení výsledku do proměnné typu Object nemění skutečný typ objektu: stále jde o Integer.

Přetížené varianty Integer.valueOf(String) a Integer.valueOf(String, int) nejprve parsují celé číslo se znaménkem, v desítkové soustavě nebo v soustavě se zadaným základem. Neplatný text, null, hodnota mimo rozsah int nebo nepovolený základ způsobí NumberFormatException. Pokud potřebuješ výsledek typu int, použij odpovídající variantu Integer.parseInt.

Integer.valueOf(int) zaručuje sdílení instancí pro hodnoty od -128 do 127 včetně. Mimo tento rozsah může instance sdílet také, ale nespoléhej na to. U dvou referencí Integer zjišťuje ==, zda odkazují na stejný objekt; pro porovnání hodnot dvou objektů, jejichž reference nejsou null, použij equals. Při porovnání Integer s int operátor == rozbalí hodnotu a porovná čísla. Rozbalení null vyvolá NullPointerException.

Ve vnořeném map vrací word.length() hodnotu typu int. Volání Integer.valueOf(word.length()) délku explicitně zabalí, takže každou skupinu lze shromáždit do List<Integer>.

Příklady

import java.util.List;
import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        Object boxed = Integer.valueOf(42);
        System.out.println(boxed);
        System.out.println(boxed == Integer.valueOf(42));

        List<List<Integer>> lengths = Stream.of(List.of("Java", "SE"), List.of("API"))
                .map(group -> group.stream()
                        .map(word -> Integer.valueOf(word.length()))
                        .toList())
                .toList();

        System.out.println(lengths.get(0).get(0) + ", " + lengths.get(0).get(1));
        System.out.println(lengths.get(1).get(0));
    }
}

Výsledek

42
true
4, 2
3

Proměnná `boxed` typu `Object` obsahuje referenci na objekt `Integer` s hodnotou `42`. Porovnání vypíše `true`, protože obě volání pro `42` vracejí stejnou instanci z mezipaměti. Vnitřní `map` převádí slova na délky typu `Integer`: `4, 2` v první skupině a `3` ve druhé.

Související lekce

  • Java · Lekce 9 · Pokročilá · Verze: 2
  • Java · Lekce 44 · Středně pokročilá · Verze: 2

Zdroje