База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

String.valueOf(Object): преобразуване на обект или null в текст

При референция `null` методът връща текста `"null"`, а иначе връща резултата от `toString()` на обекта. Това правило важи за варианта с параметър `Object`.

Версия: Java SE 21

Синтаксис

public static String valueOf(Object obj)

String.valueOf(Object) е статичен метод на класа java.lang.String. Ако аргументът е референция null, методът връща низа от четири знака "null", а не референция null. В противен случай извиква реализацията на toString() за обекта и връща резултата без промяна.

Така можеш да покажеш candidate или wrong в диагностично съобщение, без да извикваш метод на обект чрез референция null. Това не е сериализация или проверка за липсваща стойност: референцията null и низът "null" дават един и същ текст. Ако разликата е важна, провери аргумента преди преобразуването. Ако toString() върне null или хвърли изключение, valueOf(Object) не заменя този резултат с низа "null".

Компилаторът избира кой от претоварените варианти да извика според типа на аргумента, известен при компилация. String.valueOf(null) избира по-специфичния вариант String.valueOf(char[]) и хвърля NullPointerException. Използвай String.valueOf((Object) null) или подай променлива от тип Object, за да избереш варианта за обекти. Когато char[] не е null, вариантът за масиви копира знаците в низ. Ако подадеш същия масив като Object, вместо това се извиква неговият toString().

Примери

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

Резултат

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

`candidate` използва своята реализация на `toString()`, а сравнението потвърждава, че `wrong` дава текста `"null"`. Масивът от знаци дава `ok`. Последният ред се отпечатва от блока `catch` след извикването с литерала `null` без явно преобразуване на типа.

Свързани уроци

  • Java · Урок 58 · Начално · Версия: 2
  • Java · Урок 37 · Средно · Версия: 2

Източници