CKTIS / Java
String.valueOf(Object): convertir un objeto o null en texto
El método devuelve el texto `"null"` para una referencia nula; si hay un objeto, devuelve el resultado de su `toString()`. Esta regla corresponde a la sobrecarga de `Object`.
Versión: Java SE 21
Sintaxis
public static String valueOf(Object obj)String.valueOf(Object) es un método estático de java.lang.String. Si el argumento es una referencia null, devuelve la cadena de cuatro caracteres "null", no una referencia nula. En caso contrario, llama a la implementación de toString() del objeto y devuelve el resultado sin modificarlo.
Puedes mostrar candidate o wrong en un mensaje de diagnóstico sin llamar a un método de instancia sobre una referencia nula. No es una forma de serializar ni de detectar valores ausentes: una referencia nula y la cadena "null" producen el mismo texto. Si necesitas distinguirlas, comprueba el argumento antes de convertirlo. Si toString() devuelve null o lanza una excepción, valueOf(Object) no lo sustituye por la cadena "null".
El compilador elige la sobrecarga según el tipo del argumento en tiempo de compilación. String.valueOf(null) selecciona la sobrecarga más específica String.valueOf(char[]) y lanza NullPointerException. Usa String.valueOf((Object) null) o pasa una variable de tipo Object para elegir la sobrecarga para objetos. Con un char[] no nulo, la sobrecarga para arrays copia los caracteres en una cadena; si pasas el mismo array como Object, en su lugar se llama a su toString().
Ejemplos
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");
}
}
}Resultado
candidate=score=7 wrong is the text null: true chars=ok bare null: NullPointerException
`candidate` usa su propio `toString()` y la comparación confirma que `wrong` se convierte en el texto `"null"`. El array de caracteres produce `ok`. La última línea sale del bloque `catch` tras la llamada con el literal `null` sin conversión de tipo.
Lecciones relacionadas
- Java · Lección 58 · Básico · Versión: 2
- Java · Lección 37 · Intermedio · Versión: 2