Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes