CKTIS / Java
String.valueOf(Object): converter um objeto ou null em texto
O método devolve o texto `"null"` para uma referência nula e, nos outros casos, o resultado de `toString()`. Esta regra aplica-se à sobrecarga com parâmetro `Object`.
Versão: Java SE 21
Sintaxe
public static String valueOf(Object obj)String.valueOf(Object) é um método estático de java.lang.String. Se o argumento for uma referência null, devolve a cadeia de quatro caracteres "null", e não uma referência nula. Caso contrário, chama a implementação de toString() do objeto e devolve o resultado sem o alterar.
Podes apresentar candidate ou wrong numa mensagem de diagnóstico sem chamar um método de instância sobre uma referência nula. Isto não é serialização nem um teste para detetar valores em falta: uma referência nula e a cadeia "null" produzem o mesmo texto. Se a distinção for importante, verifica o argumento antes de o converter. Se toString() devolver null ou lançar uma exceção, valueOf(Object) não substitui esse desfecho pela cadeia "null".
O compilador escolhe a sobrecarga com base no tipo do argumento em tempo de compilação. String.valueOf(null) seleciona a sobrecarga mais específica String.valueOf(char[]) e lança uma NullPointerException. Usa String.valueOf((Object) null) ou passa uma variável do tipo Object para selecionar a sobrecarga para objetos. Com um char[] não nulo, a sobrecarga para arrays copia os caracteres para uma cadeia. Se passares o mesmo array como Object, é chamado o seu toString() em vez de se copiarem os caracteres.
Exemplos
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 o seu próprio `toString()` e a comparação confirma que `wrong` se torna o texto `"null"`. O array de caracteres produz `ok`. A última linha vem do bloco `catch` após a chamada com o literal `null` sem conversão de tipo.
Lições relacionadas
- Java · Lição 58 · Básico · Versão: 2
- Java · Lição 37 · Intermédio · Versão: 2