CKTIS / Java
String.valueOf — преобразуване на стойности в текст и обработка на null
Използвай `String.valueOf`, за да преобразуваш стойност в текст. Липсващо съобщение на изключение става `"null"`, но директното подаване на литерала `null` предизвиква изключение.
Версия: Java SE 21
Синтаксис
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)В Java SE 21 String.valueOf има няколко статични претоварени варианта в класа java.lang.String. Вариантът valueOf(Object) връща низа "null", когато аргументът е null. В противен случай връща резултата от obj.toString() и не прихваща изключенията, хвърлени от този метод.
Ако ex сочи към съществуващо изключение, използвай String.valueOf(ex.getMessage()), за да покажеш съобщението му. Типът на резултата от getMessage() е String, затова компилаторът избира варианта Object дори когато съобщението липсва. Това не предпазва при ex == null: аргументът се оценява първо. След преобразуването липсващо съобщение не може да се различи от съобщение с точно съдържание "null".
Не използвай String.valueOf(null), за да получиш низа "null". Компилаторът избира char[] вместо Object, защото char[] е по-специфичен тип, и извикването хвърля NullPointerException. С String.valueOf((Object) null) изрично избираш варианта Object.
Има отделни варианти за примитивните типове boolean, char, int, long, float и double. Вариантът char[] копира целия масив, а valueOf(data, offset, count) копира count елемента от индекс offset, като индексите започват от нула. Последващи промени в масива не променят резултата. Невалиден диапазон предизвиква IndexOutOfBoundsException.
Примери
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));
}
}Резултат
missing: [null] present: [Disk full] missing == null: false
`getMessage()` връща `null` за първото изключение и `"Disk full"` за второто. Резултатът `false` потвърждава, че `missing` съдържа низа `"null"`, а не референция със стойност `null`.
Свързани уроци
- Java · Урок 30 · Средно · Версия: 2