CKTIS / Java
String.valueOf — convertir valores en texto y tratar null
Usa `String.valueOf` para convertir valores en texto. Un mensaje de excepción ausente se convierte en `"null"`, pero pasar directamente el literal `null` provoca una excepción.
Versión: Java SE 21
Sintaxis
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)En Java SE 21, String.valueOf agrupa varias sobrecargas estáticas de java.lang.String. La sobrecarga valueOf(Object) devuelve la cadena "null" cuando su argumento es null. Si recibe un objeto no nulo, devuelve el resultado de obj.toString() y no captura las excepciones que lance ese método.
Si ex hace referencia a una excepción existente, usa String.valueOf(ex.getMessage()) para mostrar su mensaje. El tipo de retorno de getMessage() es String, por lo que el compilador elige la sobrecarga Object aunque no haya mensaje. Esto no protege frente a ex == null: el argumento se evalúa primero. Tras la conversión, un mensaje ausente es indistinguible de uno cuyo contenido sea exactamente "null".
No uses String.valueOf(null) para obtener la cadena "null". El compilador elige char[] en lugar de Object porque es más específico, y la llamada lanza NullPointerException. Usa String.valueOf((Object) null) para seleccionar explícitamente la sobrecarga Object.
Hay sobrecargas específicas para los tipos primitivos boolean, char, int, long, float y double. La sobrecarga char[] copia todo el array, mientras que valueOf(data, offset, count) copia count elementos desde el índice offset, contando desde cero. Los cambios posteriores en el array no alteran el resultado. Un intervalo no válido provoca IndexOutOfBoundsException.
Ejemplos
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));
}
}Resultado
missing: [null] present: [Disk full] missing == null: false
`getMessage()` devuelve `null` para la primera excepción y `"Disk full"` para la segunda. El resultado `false` confirma que `missing` contiene la cadena `"null"`, no una referencia nula.
Lecciones relacionadas
- Java · Lección 30 · Intermedio · Versión: 2