CKTIS / Java
String.valueOf — convertir une valeur en texte et gérer null
Utilisez `String.valueOf` pour convertir une valeur en texte. Un message d’exception absent devient `"null"`, mais passer directement le littéral `null` déclenche une exception.
Version : Java SE 21
Syntaxe
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)Dans Java SE 21, String.valueOf désigne plusieurs surcharges statiques de java.lang.String. La surcharge valueOf(Object) renvoie la chaîne "null" si son argument vaut null. Pour un objet non nul, elle renvoie le résultat de obj.toString() et n’intercepte pas les exceptions levées par cette méthode.
Si ex référence une exception existante, utilisez String.valueOf(ex.getMessage()) pour afficher son message. Le type de retour de getMessage() est String : le compilateur choisit donc la surcharge Object, même si le message est absent. Cela ne protège pas contre ex == null, car l’argument est évalué en premier. Après conversion, un message absent est impossible à distinguer d’un message dont le contenu est exactement "null".
N’utilisez pas String.valueOf(null) pour obtenir la chaîne "null". Le compilateur choisit char[] plutôt que Object, car ce type est plus spécifique, et l’appel lève une NullPointerException. Utilisez String.valueOf((Object) null) pour sélectionner explicitement la surcharge Object.
Les types primitifs boolean, char, int, long, float et double ont chacun leur surcharge. La surcharge char[] copie tout le tableau, tandis que valueOf(data, offset, count) copie count éléments à partir de l’indice offset, en comptant depuis zéro. Les modifications ultérieures du tableau ne changent pas le résultat. Une plage non valide déclenche une IndexOutOfBoundsException.
Exemples
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));
}
}Résultat
missing: [null] present: [Disk full] missing == null: false
`getMessage()` renvoie `null` pour la première exception et `"Disk full"` pour la seconde. Le résultat `false` confirme que `missing` contient la chaîne `"null"` et non une référence nulle.
Leçons associées
- Java · Leçon 30 · Intermédiaire · Version : 2