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 NumberFormatExceptionInteger.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
- Java SE 21 API — Integer.valueOf(int)
- Java SE 21 API — Integer.valueOf(String)
- Java SE 21 API — Integer.valueOf(String, int)
- Java SE 21 API — Integer.equals(Object)
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion and §5.1.8 Unboxing Conversion
- Java Language Specification, Java SE 21 — §15.21 Equality Operators
- Java SE 21 API — Stream.map(Function)
- Java SE 21 API — Stream.toList()