CKTIS / Java
String.valueOf(Object) : convertir un objet ou null en texte
La méthode renvoie le texte `"null"` pour une référence nulle et le résultat de `toString()` sinon. Cette règle concerne la surcharge qui prend un `Object`.
Version : Java SE 21
Syntaxe
public static String valueOf(Object obj)String.valueOf(Object) est une méthode statique de java.lang.String. Si l’argument est une référence null, elle renvoie la chaîne de quatre caractères "null", et non une référence nulle. Sinon, elle appelle l’implémentation de toString() de l’objet et en renvoie le résultat sans le modifier.
Tu peux ainsi afficher candidate ou wrong dans un message de diagnostic sans appeler une méthode d’instance sur une référence nulle. Ce n’est ni une sérialisation ni un test de valeur manquante : une référence nulle et la chaîne "null" produisent le même texte. Si la différence importe, vérifie l’argument avant la conversion. Si toString() renvoie null ou lève une exception, valueOf(Object) ne remplace pas ce résultat par la chaîne "null".
Le compilateur choisit la surcharge selon le type de l’argument connu à la compilation. String.valueOf(null) sélectionne la surcharge plus spécifique String.valueOf(char[]) et lève une NullPointerException. Utilise String.valueOf((Object) null) ou passe une variable de type Object pour sélectionner la surcharge pour les objets. Pour un char[] non nul, la surcharge pour les tableaux copie les caractères dans une chaîne. Passer le même tableau comme Object appelle à la place son toString().
Exemples
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");
}
}
}Résultat
candidate=score=7 wrong is the text null: true chars=ok bare null: NullPointerException
`candidate` utilise son propre `toString()`. La comparaison confirme que `wrong` donne le texte `"null"`. Le tableau de caractères donne `ok`. La dernière ligne provient du bloc `catch`, après l’appel avec le littéral `null` seul.
Leçons associées
- Java · Leçon 58 · Débutant · Version : 2
- Java · Leçon 37 · Intermédiaire · Version : 2