KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.valueOf(Object): een object of null omzetten naar tekst

De methode geeft voor een nullreferentie de tekst `"null"` terug en anders het resultaat van `toString()`. Die regel geldt voor de overload met `Object`.

Versie: Java SE 21

Syntax

public static String valueOf(Object obj)

String.valueOf(Object) is een statische methode van java.lang.String. Is het argument een null-referentie, dan retourneert de methode de tekenreeks "null" van vier tekens, niet een nullreferentie. Anders roept ze de toString()-implementatie van het object aan en geeft ze het resultaat ongewijzigd terug.

Zo kun je candidate of wrong in een diagnosebericht weergeven zonder een instantiemethode op een nullreferentie aan te roepen. Dit is geen serialisatie en ook geen test op ontbrekende waarden: een nullreferentie en de tekenreeks "null" leveren dezelfde tekst op. Controleer het argument vóór de omzetting als het verschil belangrijk is. Geeft toString() null terug of gooit die methode een uitzondering, dan vervangt valueOf(Object) die uitkomst niet door de tekenreeks "null".

De compiler kiest de overload op basis van het type van het argument tijdens compilatie. String.valueOf(null) kiest de specifiekere overload String.valueOf(char[]) en gooit een NullPointerException. Gebruik String.valueOf((Object) null) of geef een variabele van het type Object door om de objectoverload te kiezen. Bij een char[] dat niet null is, kopieert de array-overload de tekens naar een tekenreeks. Geef je dezelfde array door als Object, dan wordt in plaats daarvan de toString() van de array aangeroepen.

Voorbeelden

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

Resultaat

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

`candidate` gebruikt zijn eigen `toString()`. De vergelijking bevestigt dat `wrong` de tekst `"null"` oplevert. De tekenarray levert `ok` op. De laatste regel komt uit het `catch`-blok na de aanroep met alleen de letterlijke waarde `null`.

Gerelateerde lessen

  • Java · Les 58 · Basis · Versie: 2
  • Java · Les 37 · Gemiddeld · Versie: 2

Bronnen