CKTIS / Java
String.valueOf(Object): pretvorba objekta ali null v besedilo
Za referenco `null` metoda vrne besedilo `"null"`, sicer pa rezultat objektove metode `toString()`. To pravilo velja za preobremenjeno različico s parametrom `Object`.
Različica: Java SE 21
Sintaksa
public static String valueOf(Object obj)String.valueOf(Object) je statična metoda razreda java.lang.String. Če je argument referenca null, vrne niz "null" s štirimi znaki, ne reference null. Sicer pokliče objektovo implementacijo metode toString() in njen rezultat vrne nespremenjen.
Tako lahko prikažeš candidate ali wrong v diagnostičnem sporočilu, ne da bi klical instančno metodo na referenci null. To ni serializacija niti preizkus, ali vrednost manjka: referenca null in niz "null" dasta enako besedilo. Če je razlika pomembna, preveri argument pred pretvorbo. Če toString() vrne null ali sproži izjemo, valueOf(Object) tega ne nadomesti z nizom "null".
Prevajalnik izbere preobremenjeno različico na podlagi tipa argumenta, znanega ob prevajanju. String.valueOf(null) izbere bolj specifično različico String.valueOf(char[]) in sproži NullPointerException. Za izbiro različice za objekte uporabi String.valueOf((Object) null) ali podaj spremenljivko tipa Object. Če char[] ni null, različica za tabele kopira znake v niz. Če isto tabelo podaš kot Object, se namesto tega pokliče njen toString().
Primeri
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");
}
}
}Rezultat
candidate=score=7 wrong is the text null: true chars=ok bare null: NullPointerException
`candidate` uporabi svojo metodo `toString()`, primerjava pa potrdi, da `wrong` da besedilo `"null"`. Tabela znakov da `ok`. Zadnjo vrstico izpiše blok `catch` po klicu s samim literalom `null`.
Povezane lekcije
- Java · Lekcija 58 · Osnovna · Različica: 2
- Java · Lekcija 37 · Srednja · Različica: 2