WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.valueOf — Werte in Text umwandeln und null behandeln

Mit `String.valueOf` wandelst du Werte in Text um. Eine fehlende Ausnahmemeldung ergibt `"null"`; ein direkt übergebenes `null`-Literal löst dagegen eine Ausnahme aus.

Version: Java SE 21

Syntax

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)

In Java SE 21 gibt es in java.lang.String mehrere statische Überladungen von String.valueOf. Die Variante valueOf(Object) liefert die Zeichenkette "null", wenn das Argument null ist. Bei einem Objekt, das nicht null ist, liefert sie das Ergebnis von obj.toString() und fängt keine Ausnahmen ab, die diese Methode auslöst.

Wenn ex auf ein vorhandenes Ausnahmeobjekt verweist, kannst du dessen Meldung mit String.valueOf(ex.getMessage()) anzeigen. Der Rückgabetyp von getMessage() ist String; deshalb wählt der Compiler auch bei fehlender Meldung die Variante Object. Das schützt nicht vor ex == null: Das Argument wird zuerst ausgewertet. Nach der Umwandlung ist eine fehlende Meldung nicht mehr von einer Meldung mit dem genauen Inhalt "null" zu unterscheiden.

Verwende nicht String.valueOf(null), um die Zeichenkette "null" zu erhalten. Der Compiler wählt char[], weil dieser Typ spezifischer als Object ist. Der Aufruf löst eine NullPointerException aus. Mit String.valueOf((Object) null) wählst du ausdrücklich die Variante Object.

Für die primitiven Typen boolean, char, int, long, float und double gibt es eigene Überladungen. Die Variante char[] kopiert das ganze Array; valueOf(data, offset, count) kopiert count Elemente ab dem nullbasierten Index offset. Spätere Änderungen am Array ändern das Ergebnis nicht. Ein ungültiger Bereich löst eine IndexOutOfBoundsException aus.

Beispiele

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

Ergebnis

missing: [null]
present: [Disk full]
missing == null: false

`getMessage()` liefert für die erste Ausnahme `null` und für die zweite `"Disk full"`. Das Ergebnis `false` bestätigt, dass `missing` die Zeichenkette `"null"` enthält und keine Nullreferenz ist.

Zugehörige Lektionen

  • Java · Lektion 30 · Mittlere Stufe · Version: 2

Quellen