CKTIS / Java
String.valueOf(Object): převod objektu nebo null na text
Pro referenci `null` metoda vrátí text `"null"`, jinak výsledek metody `toString()` daného objektu. Toto pravidlo platí pro přetížení s parametrem `Object`.
Verze: Java SE 21
Syntaxe
public static String valueOf(Object obj)String.valueOf(Object) je statická metoda třídy java.lang.String. Pokud je argumentem reference null, vrátí čtyřznakový řetězec "null", nikoli referenci null. Jinak zavolá implementaci toString() daného objektu a vrátí její výsledek beze změny.
Tak můžeš zobrazit hodnotu candidate nebo wrong v diagnostické zprávě, aniž bys volal instanční metodu na referenci null. Nejde o serializaci ani o test chybějící hodnoty: reference null a řetězec "null" dávají stejný text. Pokud na rozdílu záleží, zkontroluj argument před převodem. Jestliže toString() vrátí null nebo vyvolá výjimku, valueOf(Object) tento výsledek nenahradí řetězcem "null".
Překladač vybírá přetížení podle typu argumentu známého při překladu. String.valueOf(null) vybere konkrétnější přetížení String.valueOf(char[]) a vyvolá NullPointerException. Pro výběr přetížení pro objekty použij String.valueOf((Object) null) nebo předej proměnnou typu Object. Pro char[], které není null, přetížení pro pole zkopíruje znaky do řetězce. Pokud ale stejné pole předáš jako Object, zavolá se místo toho jeho toString().
Příklady
public class Main {
record Candidate(int score) {
@Override
public String toString() {
return "score=" + score;
}
}
public static void main(String[] args) {
Object candidate = new Candidate(7);
Object wrong = null;
System.out.println("candidate=" + String.valueOf(candidate));
String wrongText = String.valueOf(wrong);
System.out.println("wrong is the text null: " + "null".equals(wrongText));
System.out.println("chars=" + String.valueOf(new char[] {'o', 'k'}));
try {
String.valueOf(null);
} catch (NullPointerException e) {
System.out.println("bare null: NullPointerException");
}
}
}Výsledek
candidate=score=7 wrong is the text null: true chars=ok bare null: NullPointerException
`candidate` používá vlastní `toString()` a porovnání potvrzuje, že `wrong` dává text `"null"`. Pole znaků dává `ok`. Poslední řádek vypíše blok `catch` po volání se samotným literálem `null`.
Související lekce
- Java · Lekce 58 · Základní · Verze: 2
- Java · Lekce 37 · Středně pokročilá · Verze: 2