Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.valueOf(Object): obiekt lub null jako tekst

Metoda zwraca tekst `"null"` dla referencji `null`, a dla obiektu zwraca wynik jego `toString()`. To zachowanie dotyczy przeciążenia z parametrem `Object`.

Wersja: Java SE 21

Składnia

public static String valueOf(Object obj)

String.valueOf(Object) to metoda statyczna klasy java.lang.String. Gdy argument jest referencją null, zwraca napis "null" (cztery znaki), a nie referencję null. W przeciwnym razie zwraca bez zmian wynik obj.toString(), używając implementacji właściwej dla obiektu.

W komunikacie diagnostycznym możesz wyświetlić candidate lub wrong bez wywoływania metody instancji na referencji null. Nie jest to jednak serializacja ani sposób sprawdzania, czy brakowało wartości: zarówno referencja null, jak i napis "null" dają ten sam tekst. Jeśli to rozróżnienie jest ważne, sprawdź argument przed konwersją. Jeśli toString() zwróci null lub rzuci wyjątek, valueOf(Object) nie zastąpi tego napisem "null".

Kompilator wybiera przeciążenie na podstawie typu argumentu znanego podczas kompilacji. String.valueOf(null) wybiera bardziej szczegółowe przeciążenie String.valueOf(char[]) i rzuca NullPointerException. Użyj String.valueOf((Object) null) lub przekaż zmienną typu Object, aby wybrać przeciążenie obiektowe. Dla niepustej referencji typu char[] przeciążenie tablicowe kopiuje znaki do napisu; przekazanie tej samej tablicy jako Object wywołuje jej toString() zamiast kopiować znaki.

Przykłady

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

Wynik

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

`candidate` używa własnego `toString()`, a dla `wrong` porównanie potwierdza, że wynikiem jest tekst `"null"`. Tablica daje `ok`. Ostatni wiersz pochodzi z bloku `catch` po wywołaniu z samym literałem `null`.

Powiązane lekcje

  • Java · Lekcja 58 · Podstawowy · Wersja: 2
  • Java · Lekcja 37 · Średniozaawansowany · Wersja: 2

Źródła