Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

String.valueOf(Object): pretvorba objekta ali null v besedilo

Za referenco `null` metoda vrne besedilo `"null"`, sicer pa rezultat objektove metode `toString()`. To pravilo velja za preobremenjeno različico s parametrom `Object`.

Različica: Java SE 21

Sintaksa

public static String valueOf(Object obj)

String.valueOf(Object) je statična metoda razreda java.lang.String. Če je argument referenca null, vrne niz "null" s štirimi znaki, ne reference null. Sicer pokliče objektovo implementacijo metode toString() in njen rezultat vrne nespremenjen.

Tako lahko prikažeš candidate ali wrong v diagnostičnem sporočilu, ne da bi klical instančno metodo na referenci null. To ni serializacija niti preizkus, ali vrednost manjka: referenca null in niz "null" dasta enako besedilo. Če je razlika pomembna, preveri argument pred pretvorbo. Če toString() vrne null ali sproži izjemo, valueOf(Object) tega ne nadomesti z nizom "null".

Prevajalnik izbere preobremenjeno različico na podlagi tipa argumenta, znanega ob prevajanju. String.valueOf(null) izbere bolj specifično različico String.valueOf(char[]) in sproži NullPointerException. Za izbiro različice za objekte uporabi String.valueOf((Object) null) ali podaj spremenljivko tipa Object. Če char[] ni null, različica za tabele kopira znake v niz. Če isto tabelo podaš kot Object, se namesto tega pokliče njen toString().

Primeri

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

Rezultat

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

`candidate` uporabi svojo metodo `toString()`, primerjava pa potrdi, da `wrong` da besedilo `"null"`. Tabela znakov da `ok`. Zadnjo vrstico izpiše blok `catch` po klicu s samim literalom `null`.

Povezane lekcije

  • Java · Lekcija 58 · Osnovna · Različica: 2
  • Java · Lekcija 37 · Srednja · Različica: 2

Viri