CKTIS / Java
String.valueOf — převod hodnot na text a zpracování null
Pomocí `String.valueOf` převedeš hodnotu na text. Chybějící zpráva výjimky se převede na `"null"`, ale předání samotného literálu `null` vyvolá výjimku.
Verze: Java SE 21
Syntaxe
public static String valueOf(Object obj)
public static String valueOf(char[] data)
public static String valueOf(char[] data, int offset, int count)
public static String valueOf(boolean b)
public static String valueOf(char c)
public static String valueOf(int i)
public static String valueOf(long l)
public static String valueOf(float f)
public static String valueOf(double d)V Java SE 21 má String.valueOf několik statických přetížení ve třídě java.lang.String. Varianta valueOf(Object) vrací řetězec "null", pokud má argument hodnotu null. Jinak vrací výsledek obj.toString() a nezachytává výjimky vyvolané touto metodou.
Pokud ex odkazuje na existující výjimku, její zprávu můžeš zobrazit pomocí String.valueOf(ex.getMessage()). Návratový typ metody getMessage() je String, proto překladač zvolí variantu Object, i když zpráva chybí. Před ex == null to nechrání: argument se vyhodnocuje jako první. Po převodu nelze chybějící zprávu odlišit od zprávy s obsahem přesně "null".
K získání řetězce "null" nepoužívej String.valueOf(null). Překladač zvolí char[] místo Object, protože char[] je specifičtější typ. Volání vyvolá NullPointerException. Použij String.valueOf((Object) null), pokud chceš výslovně vybrat variantu Object.
Pro primitivní typy boolean, char, int, long, float a double existují samostatná přetížení. Varianta char[] zkopíruje celé pole, zatímco valueOf(data, offset, count) zkopíruje count prvků od indexu offset, přičemž indexy začínají nulou. Pozdější změny pole výsledek nezmění. Neplatný rozsah vyvolá IndexOutOfBoundsException.
Příklady
public class Main {
public static void main(String[] args) {
Exception withoutMessage = new Exception();
Exception withMessage = new Exception("Disk full");
String missing = String.valueOf(withoutMessage.getMessage());
String present = String.valueOf(withMessage.getMessage());
System.out.println("missing: [" + missing + "]");
System.out.println("present: [" + present + "]");
System.out.println("missing == null: " + (missing == null));
}
}Výsledek
missing: [null] present: [Disk full] missing == null: false
`getMessage()` vrátí pro první výjimku `null` a pro druhou `"Disk full"`. Výsledek `false` potvrzuje, že `missing` obsahuje řetězec `"null"`, nikoli referenci `null`.
Související lekce
- Java · Lekce 30 · Středně pokročilá · Verze: 2