CKTIS / Java
String.valueOf — convertire valori in testo e gestire null
Usa `String.valueOf` per convertire valori in testo. Un messaggio di eccezione mancante diventa `"null"`, ma passare direttamente il letterale `null` causa un’eccezione.
Versione: Java SE 21
Sintassi
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)In Java SE 21, String.valueOf è un gruppo di metodi statici sovraccaricati di java.lang.String. La variante valueOf(Object) restituisce la stringa "null" quando l’argomento vale null. Per un oggetto non nullo restituisce il risultato di obj.toString() e non intercetta le eccezioni lanciate da quel metodo.
Se ex fa riferimento a un’eccezione esistente, usa String.valueOf(ex.getMessage()) per visualizzarne il messaggio. Il tipo restituito da getMessage() è String, quindi il compilatore sceglie la variante Object anche se il messaggio manca. Questo non protegge da ex == null: l’argomento viene valutato prima. Dopo la conversione, un messaggio mancante è indistinguibile da un messaggio il cui contenuto è esattamente "null".
Non usare String.valueOf(null) per ottenere la stringa "null". Il compilatore sceglie char[] invece di Object perché è più specifico, e la chiamata lancia NullPointerException. Usa String.valueOf((Object) null) per selezionare esplicitamente la variante Object.
Esistono varianti distinte per i tipi primitivi boolean, char, int, long, float e double. La variante char[] copia l’intero array, mentre valueOf(data, offset, count) copia count elementi a partire dall’indice offset, contando da zero. Le modifiche successive all’array non cambiano il risultato. Un intervallo non valido causa IndexOutOfBoundsException.
Esempi
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));
}
}Risultato
missing: [null] present: [Disk full] missing == null: false
`getMessage()` restituisce `null` per la prima eccezione e `"Disk full"` per la seconda. Il risultato `false` conferma che `missing` contiene la stringa `"null"`, non un riferimento nullo.
Lezioni correlate
- Java · Lezione 30 · Intermedio · Versione: 2