KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.valueOf — waarden omzetten naar tekst en omgaan met null

Gebruik `String.valueOf` om waarden om te zetten naar tekst. Een ontbrekend uitzonderingsbericht wordt `"null"`, maar de letterlijke waarde `null` als argument veroorzaakt een uitzondering.

Versie: 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 heeft java.lang.String verschillende statische overloads van String.valueOf. De overload valueOf(Object) geeft de tekenreeks "null" terug als het argument null is. Bij een niet-nullobject geeft deze overload het resultaat van obj.toString() terug en vangt hij geen uitzonderingen van die methode op.

Als ex naar een bestaand exception-object verwijst, gebruik dan String.valueOf(ex.getMessage()) om het bericht te tonen. Het retourtype van getMessage() is String, dus de compiler kiest de Object-overload, ook als het bericht ontbreekt. Dit biedt geen bescherming tegen ex == null: het argument wordt eerst geëvalueerd. Na omzetting is een ontbrekend bericht niet te onderscheiden van een bericht dat precies "null" bevat.

Gebruik String.valueOf(null) niet om de tekenreeks "null" te krijgen. De compiler kiest char[] in plaats van Object omdat char[] specifieker is. De aanroep veroorzaakt een NullPointerException. Met String.valueOf((Object) null) kies je expliciet de Object-overload.

Voor de primitieve typen boolean, char, int, long, float en double zijn er aparte overloads. De char[]-overload kopieert de hele array. valueOf(data, offset, count) kopieert count elementen vanaf index offset, waarbij indexen bij nul beginnen. Latere wijzigingen aan de array veranderen het resultaat niet. Een ongeldig bereik veroorzaakt een IndexOutOfBoundsException.

Voorbeelden

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

Resultaat

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

`getMessage()` geeft `null` terug voor de eerste uitzondering en `"Disk full"` voor de tweede. De uitkomst `false` bevestigt dat `missing` de tekenreeks `"null"` bevat en geen nullreferentie.

Gerelateerde lessen

  • Java · Les 30 · Gemiddeld · Versie: 2

Bronnen