CKTIS / Java
String.valueOf — converter valores em texto e tratar null
Usa `String.valueOf` para converter valores em texto. Uma mensagem de exceção em falta torna-se `"null"`, mas passar diretamente o literal `null` provoca uma exceção.
Versão: Java SE 21
Sintaxe
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)Em Java SE 21, String.valueOf é um conjunto de sobrecargas estáticas de java.lang.String. A sobrecarga valueOf(Object) devolve a cadeia de caracteres "null" quando o argumento é null. Para um objeto não nulo, devolve o resultado de obj.toString() e não interceta as exceções lançadas por esse método.
Se ex referenciar uma exceção existente, usa String.valueOf(ex.getMessage()) para apresentar a mensagem. O tipo de retorno de getMessage() é String, pelo que o compilador escolhe a sobrecarga Object, mesmo que não haja mensagem. Isto não protege contra ex == null: o argumento é avaliado primeiro. Após a conversão, não é possível distinguir uma mensagem em falta de uma mensagem cujo conteúdo seja exatamente "null".
Não uses String.valueOf(null) para obter a cadeia "null". O compilador escolhe char[] em vez de Object por ser mais específico, e a chamada lança NullPointerException. Usa String.valueOf((Object) null) para selecionar explicitamente a sobrecarga Object.
Há sobrecargas distintas para os tipos primitivos boolean, char, int, long, float e double. A sobrecarga char[] copia todo o array, enquanto valueOf(data, offset, count) copia count elementos a partir do índice offset, com a numeração a começar em zero. As alterações posteriores ao array não modificam o resultado. Um intervalo inválido provoca IndexOutOfBoundsException.
Exemplos
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()` devolve `null` para a primeira exceção e `"Disk full"` para a segunda. O resultado `false` confirma que `missing` contém a cadeia `"null"`, e não uma referência nula.
Lições relacionadas
- Java · Lição 30 · Intermédio · Versão: 2