CKTIS / Java
String.valueOf(Object): convertire un oggetto o null in testo
Il metodo restituisce il testo `"null"` per un riferimento nullo e il risultato di `toString()` negli altri casi. Questa regola vale per l’overload con parametro `Object`.
Versione: Java SE 21
Sintassi
public static String valueOf(Object obj)String.valueOf(Object) è un metodo statico di java.lang.String. Se l’argomento è un riferimento null, restituisce la stringa di quattro caratteri "null", non un riferimento nullo. Altrimenti invoca l’implementazione di toString() dell’oggetto e ne restituisce il risultato senza modificarlo.
Puoi visualizzare candidate o wrong in un messaggio diagnostico senza invocare un metodo di istanza su un riferimento nullo. Non è un meccanismo di serializzazione né un controllo dei valori mancanti: un riferimento nullo e la stringa "null" producono lo stesso testo. Se la distinzione è importante, controlla l’argomento prima di convertirlo. Se toString() restituisce null o lancia un’eccezione, valueOf(Object) non sostituisce tale esito con la stringa "null".
Il compilatore seleziona l’overload in base al tipo dell’argomento noto in fase di compilazione. String.valueOf(null) sceglie l’overload più specifico String.valueOf(char[]) e lancia una NullPointerException. Usa String.valueOf((Object) null) o passa una variabile di tipo Object per selezionare l’overload per oggetti. Con un char[] non nullo, l’overload per array copia i caratteri in una stringa; passando lo stesso array come Object si invoca invece il suo toString().
Esempi
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");
}
}
}Risultato
candidate=score=7 wrong is the text null: true chars=ok bare null: NullPointerException
`candidate` usa il proprio `toString()` e il confronto conferma che `wrong` diventa il testo `"null"`. L’array di caratteri produce `ok`. L’ultima riga proviene dal blocco `catch` dopo la chiamata con il solo letterale `null`.
Lezioni correlate
- Java · Lezione 58 · Base · Versione: 2
- Java · Lezione 37 · Intermedio · Versione: 2