WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.valueOf(Object): ein Objekt oder null als Text

Die Methode liefert bei einer Nullreferenz den Text `"null"`, sonst das Ergebnis von `toString()` des Objekts. Diese Regel gilt für die Überladung mit `Object`.

Version: Java SE 21

Syntax

public static String valueOf(Object obj)

String.valueOf(Object) ist eine statische Methode der Klasse java.lang.String. Ist das Argument eine null-Referenz, gibt sie die vier Zeichen "null" als Zeichenkette zurück, nicht eine Nullreferenz. Andernfalls ruft sie die toString()-Implementierung des Objekts auf und gibt deren Ergebnis unverändert zurück.

So kannst du candidate oder wrong in einer Diagnosemeldung anzeigen, ohne eine Instanzmethode auf einer Nullreferenz aufzurufen. Die Umwandlung ist weder eine Serialisierung noch ein Test auf fehlende Werte: Eine Nullreferenz und die Zeichenkette "null" ergeben denselben Text. Prüfe bei Bedarf das Argument vor der Umwandlung. Wenn toString() null zurückgibt oder eine Ausnahme auslöst, ersetzt valueOf(Object) dieses Ergebnis nicht durch "null".

Der Compiler wählt die Überladung anhand des zur Kompilierzeit bekannten Typs des Arguments. String.valueOf(null) wählt die spezifischere Überladung String.valueOf(char[]) und löst eine NullPointerException aus. Verwende String.valueOf((Object) null) oder übergib eine Variable vom Typ Object, um die Objektüberladung zu wählen. Bei einem char[], das nicht null ist, kopiert die Array-Überladung die Zeichen in eine Zeichenkette. Übergibst du dasselbe Array als Object, wird stattdessen dessen toString() aufgerufen.

Beispiele

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");
        }
    }
}

Ergebnis

candidate=score=7
wrong is the text null: true
chars=ok
bare null: NullPointerException

`candidate` verwendet sein eigenes `toString()`. Der Vergleich bestätigt, dass aus `wrong` der Text `"null"` wird. Das Zeichenarray ergibt `ok`. Die letzte Zeile stammt aus dem `catch`-Block nach dem Aufruf mit dem bloßen `null`-Literal.

Zugehörige Lektionen

  • Java · Lektion 58 · Grundlagen · Version: 2
  • Java · Lektion 37 · Mittlere Stufe · Version: 2

Quellen