CKTIS / Java
String.valueOf(Object): prevod objektu alebo null na text
Pre referenciu `null` metóda vráti text `"null"`, inak vráti výsledok metódy `toString()` daného objektu. Toto pravidlo platí pre preťaženie s parametrom `Object`.
Verzia: Java SE 21
Syntax
public static String valueOf(Object obj)String.valueOf(Object) je statická metóda triedy java.lang.String. Ak je argumentom referencia null, vráti štvorznakový reťazec "null", nie referenciu null. V opačnom prípade zavolá implementáciu toString() daného objektu a vráti jej výsledok bez zmeny.
Takto môžeš zobraziť candidate alebo wrong v diagnostickej správe bez volania inštančnej metódy na referencii null. Nejde o serializáciu ani o test chýbajúcej hodnoty: referencia null a reťazec "null" dávajú rovnaký text. Ak na rozdiele záleží, skontroluj argument pred prevodom. Ak toString() vráti null alebo vyvolá výnimku, valueOf(Object) tento výsledok nenahradí reťazcom "null".
Kompilátor vyberá preťaženie podľa typu argumentu známeho pri kompilácii. String.valueOf(null) vyberie špecifickejšie preťaženie String.valueOf(char[]) a vyvolá NullPointerException. Ak chceš vybrať preťaženie pre objekty, použi String.valueOf((Object) null) alebo odovzdaj premennú typu Object. Pre char[], ktoré nie je null, preťaženie pre polia skopíruje znaky do reťazca. Ak to isté pole odovzdáš ako Object, namiesto toho sa zavolá jeho toString().
Prí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ýsledok
candidate=score=7 wrong is the text null: true chars=ok bare null: NullPointerException
`candidate` používa vlastné `toString()` a porovnanie potvrdzuje, že `wrong` dáva text `"null"`. Pole znakov dáva `ok`. Posledný riadok vypíše blok `catch` po volaní so samotným literálom `null`.
Súvisiace lekcie
- Java · Lekcia 58 · Základná · Verzia: 2
- Java · Lekcia 37 · Stredne pokročilá · Verzia: 2